Home Assistant

Features

The entities and services Teslemetry provides within Home Assistant.

The Teslemetry integration exposes nearly every possible sensor value and commands avaliable for Tesla vehicles and energy products connected to a Teslemetry account.

Prerequisites

You must have a Teslemetry account, active subscription, and access token.

Vehicle delivered in 2024 and later require a virtual key to be configured in order to run certain commands. It is not required in older vehicles, but highly recommended for full functionality.

Streaming only entities require telemetry to be configured with the specific field.

Configuration

Simply provide your access token to the integration.

Configure Teslemetry

Entities

These are the entities available in the Teslemetry integration. Not all entities are enabled by default, and not all values are always available.

Vehicles

DomainNameMethodEnabled
Binary sensorAutomaticBlindSpotCameraStreamingNo
Binary sensorAutomaticEmergencyBrakingOffStreamingNo
Binary sensorBattery heaterBothNo
Binary sensorBlindSpotCollisionWarningChimeStreamingNo
Binary sensorBmsFullchargecompleteStreamingNo
Binary sensorBrakePedalStreamingNo
Binary sensorCabin overheat protection actively coolingPollingNo
Binary sensorCharge cablePollingYes
Binary sensorChargeEnableRequestStreamingNo
Binary sensorChargePortColdWeatherModeStreamingNo
Binary sensorCharger has multiple phasesBothNo
Binary sensorDashcamPollingNo
Binary sensorFront driver doorPollingYes
Binary sensorFront driver windowBothYes
Binary sensorFront passenger doorPollingYes
Binary sensorFront passenger windowBothYes
Binary sensorPreconditioning enabledBothNo
Binary sensorPreconditioningPollingNo
Binary sensorRear driver doorPollingYes
Binary sensorRear driver windowBothYes
Binary sensorRear passenger doorPollingYes
Binary sensorRear passenger windowBothYes
Binary sensorScheduled charging pendingBothNo
Binary sensorServiceModeStreamingNo
Binary sensorStatusPollingYes
Binary sensorTire pressure warning front leftPollingNo
Binary sensorTire pressure warning front rightPollingNo
Binary sensorTire pressure warning rear leftPollingNo
Binary sensorTire pressure warning rear rightPollingNo
Binary sensorTrip chargingPollingNo
Binary sensorUser presentPollingYes
ButtonFlash lightsPollingYes
ButtonForce refreshPollingYes
ButtonHomelinkPollingYes
ButtonHonk hornPollingYes
ButtonKeyless drivingPollingYes
ButtonPlay fartPollingYes
ButtonWakePollingYes
ClimateCabin overheat protectionPolling1Yes
ClimateClimatePolling1Yes
CoverCharge port doorBothYes
CoverFrunkPollingYes
CoverTrunkPollingYes
CoverVent windowsPollingYes
Device trackerLocationBothYes
Device trackerRoutePollingYes
LockCharge cable lockBothYes
LockLockBothYes
LockSpeed limitBothYes
Media playerMedia PlayerPollingYes
NumberCharge currentBothYes
NumberCharge limitBothYes
NumberSpeed limitBothYes
SelectSeat heater front leftBothYes
SelectSeat heater front rightBothYes
SelectSeat heater rear centerBothNo
SelectSeat heater rear leftBothNo
SelectSeat heater rear rightBothNo
SelectSeat heater third row leftPollingNo
SelectSeat heater third row rightPollingNo
SelectSteering wheel heaterPollingYes
SensorBMSStateStreamingNo
SensorBattery levelBothYes
SensorBattery rangePollingYes
SensorBrakePedalPosStreamingNo
SensorBrickVoltageMaxStreamingNo
SensorBrickVoltageMinStreamingNo
SensorCarTypeStreamingNo
SensorCharge cablePollingNo
SensorCharge energy addedBothYes
SensorCharge ratePollingYes
SensorChargeCurrentRequestMaxStreamingNo
SensorChargePortStreamingNo
SensorCharger currentBothYes
SensorCharger powerBothYes
SensorCharger voltagePollingYes
SensorChargingBothYes
SensorCruiseFollowDistanceStreamingNo
SensorCruiseSetSpeedStreamingNo
SensorDCChargingEnergyInStreamingNo
SensorDCChargingPowerStreamingNo
SensorDCDCEnableStreamingNo
SensorDestinationLocationStreamingNo
SensorDiAxleSpeedFStreamingNo
SensorDiAxleSpeedRELStreamingNo
SensorDiAxleSpeedRERStreamingNo
SensorDiAxleSpeedRStreamingNo
SensorDiHeatsinkTFStreamingNo
SensorDiHeatsinkTRELStreamingNo
SensorDiHeatsinkTRERStreamingNo
SensorDiHeatsinkTRStreamingNo
SensorDiMotorCurrentFStreamingNo
SensorDiMotorCurrentRELStreamingNo
SensorDiMotorCurrentRERStreamingNo
SensorDiMotorCurrentRStreamingNo
SensorDiSlaveTorqueCmdStreamingNo
SensorDiStateFStreamingNo
SensorDiStateRELStreamingNo
SensorDiStateRERStreamingNo
SensorDiStateRStreamingNo
SensorDiStatorTempFStreamingNo
SensorDiStatorTempRELStreamingNo
SensorDiStatorTempRERStreamingNo
SensorDiStatorTempRStreamingNo
SensorDiTorqueActualFStreamingNo
SensorDiTorqueActualRELStreamingNo
SensorDiTorqueActualRERStreamingNo
SensorDiTorqueActualRStreamingNo
SensorDiTorquemotorStreamingNo
SensorDiVBatFStreamingNo
SensorDiVBatRELStreamingNo
SensorDiVBatRERStreamingNo
SensorDiVBatRStreamingNo
SensorDistance to arrivalBothYes
SensorDoorStateStreamingNo
SensorDriveRailStreamingNo
SensorDriver temperature settingPollingNo
SensorDriverSeatBeltStreamingNo
SensorDriverSeatOccupiedStreamingNo
SensorEmergencyLaneDepartureAvoidanceStreamingNo
SensorEnergyRemainingStreamingNo
SensorEstimate battery rangeBothNo
SensorExterior colorBothNo
SensorFast charger typePollingNo
SensorFastChargerPresentStreamingNo
SensorForwardCollisionWarningStreamingNo
SensorGpsHeadingStreamingNo
SensorGpsStateStreamingNo
SensorGuestModeEnabledStreamingNo
SensorGuestModeMobileAccessStateStreamingNo
SensorHvilStreamingNo
SensorIdeal battery rangeBothNo
SensorInside temperatureBothYes
SensorIsolationResistanceStreamingNo
SensorLaneDepartureAvoidanceStreamingNo
SensorLateralAccelerationStreamingNo
SensorLifetimeEnergyGainedRegenStreamingNo
SensorLifetimeEnergyUsedDriveStreamingNo
SensorLifetimeEnergyUsedStreamingNo
SensorLongitudinalAccelerationStreamingNo
SensorModuleTempMaxStreamingNo
SensorModuleTempMinStreamingNo
SensorNotEnoughPowerToHeatStreamingNo
SensorNumBrickVoltageMaxStreamingNo
SensorNumBrickVoltageMinStreamingNo
SensorNumModuleTempMaxStreamingNo
SensorNumModuleTempMinStreamingNo
SensorOdometerBothNo
SensorOriginLocationStreamingNo
SensorOutside temperatureBothYes
SensorPackCurrentStreamingNo
SensorPackVoltageStreamingNo
SensorPairedPhoneKeyAndKeyFobQtyStreamingNo
SensorPassenger temperature settingPollingNo
SensorPassengerSeatBeltStreamingNo
SensorPedalPositionStreamingNo
SensorPinToDriveEnabledStreamingNo
SensorPowerPollingNo
SensorRatedRangeStreamingNo
SensorRoof colorBothNo
SensorRouteLastUpdatedStreamingNo
SensorRouteLineStreamingNo
SensorScheduled charging modeBothNo
SensorScheduled charging start timeBothNo
SensorScheduled departure timeBothNo
SensorShift stateBothNo
SensorSocStreamingNo
SensorSpeedLimitWarningStreamingNo
SensorSpeedBothNo
SensorState of charge at arrivalPollingNo
SensorSuperchargerSessionTripPlannerStreamingNo
SensorTime at arrivalPollingYes
SensorTime at full chargePollingYes
SensorTime to arrivalBothYes
SensorTime to arrivalBothYes
SensorTime to full chargeBothYes
SensorTime to full chargeBothYes
SensorTire pressure front leftBothNo
SensorTire pressure front rightBothNo
SensorTire pressure last measured front leftBothNo
SensorTire pressure last measured front rightBothNo
SensorTire pressure last measured rear leftBothNo
SensorTire pressure last measured rear rightBothNo
SensorTire pressure rear leftBothNo
SensorTire pressure rear rightBothNo
SensorTraffic delayPollingNo
SensorTrimStreamingNo
SensorUsable Battery levelPollingNo
SensorVehicleNameStreamingNo
SensorVersionStreamingNo
SwitchAuto seat climate leftBothYes
SwitchAuto seat climate rightBothYes
SwitchAuto steering wheel heaterPollingYes
SwitchChargePollingYes
SwitchDefrostPollingYes
SwitchSentry modeBothYes
SwitchValet modePollingYes
UpdateUpdateBoth2Yes

1 Only Inside temperature attribute is streamable. 2 Only Version attribute is streamable

Energy sites

DomainNameMethodEnabled
Binary sensorBackup capablePollingYes
Binary sensorGrid services activePollingYes
Binary sensorGrid services enabledPollingYes
NumberBackup reservePollingYes
NumberOff grid reservePollingYes
SensorBattery powerPollingYes
SensorEnergy leftPollingYes
SensorGenerator powerPollingNo
SensorGrid powerPollingYes
SensorGrid services powerPollingYes
SensorIsland statusPollingYes
SensorLoad powerPollingYes
SensorPercentage chargedPollingYes
SensorSolar powerPollingYes
SensorTotal pack energyPollingNo
SensorVPP backup reservePollingYes
SensorVersionPollingYes
SelectAllow exportPollingYes
SelectOperation modePollingYes
SwitchAllow charging from gridPollingYes
SwitchStorm modePollingYes

Wall connector

DomainNameMethodEnabled
SensorFault statePollingNo
SensorPowerPollingYes
SensorStatePollingYes
SensorVehiclePollingYes

Services

The services are all documented inside Home Assistant as well, so its recommended you start with the services developer tool (developer-tools/service) to correctly format your service calls.

teslemetry.navigation_gps_request

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
gpsDictionary of coordinates
gps.latitudeLatitude in degrees-27.9699373
gps.longitudeLongitude in degrees153.4081865
orderOrder for this destination1

teslemetry.navigation_sc_request

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
idSupercharged IDUnknown
orderOrder for this destination1

teslemetry.navigation_request

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
typeUnknownUnknown
valueLocation to navigate toUnknown
localeISO stringen-au
timestamp_msUnknownUnknown

Set scheduled charging

teslemetry.set_scheduled_charging

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
enableEnable or disable scheduled charging.true
timeTime to start charging in HH:MM6:00

Set scheduled departure

teslemetry.set_scheduled_departure

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
enableEnable or disable scheduled departuretrue
preconditioning_enabledEnable preconditioningtrue
preconditioning_weekdays_onlyEnable preconditioning on weekdays onlyfalse
departure_timeTime to precondition by (HH:MM)6:00
off_peak_charging_enabledEnable off peak chargingfalse
off_peak_charging_weekdays_onlyEnable off peak charging on weekdays onlyfalse
end_off_peak_timeTime to complete charging by (HH:MM)5:00

Valet Mode

teslemetry.valet_mode

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
enableEnable or disable valet modetrue
pin4 digit pin1234

Speed Limit

teslemetry.speed_limit

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
enableEnable or disable speed limittrue
pin4 digit pin1234

Time of use

teslemetry.time_of_use

FieldDescriptionExample
device_idThe vehicles device_id0d462c0c4c0b064b1a91cdbd1ffcbd31
tou_settingsTime of use settingsSee https://developer.tesla.com/docs/fleet-api#time_of_use_settings for details

Stream fields

teslemetry.stream_fields

The stream fields service replaces the fields in your streaming configuration, and uses the same structure as the Tesla Fleet API to ensure future compatibility.

service: teslemetry.stream_fields
data:
  device_id: 0d462c0c4c0b064b1a91cdbd1ffcbd31
  fields:
    BatteryLevel:
      interval_seconds: 60

Events

Teslemetry also exposes certain events directly.

Streaming alerts

When streaming is configured, alerts and errors reported by your vehicles will be sent on the event bus as teslemetry_alert and teselemetry_error.

event_type: teslemetry_alert
data:
  name: VCFRONT_a186_noDriveChgCableCon
  audiences:
    - Customer
  startedAt: "2024-04-07T02:03:17.775Z"
  endedAt: "2024-04-07T02:03:18.778Z"
  vin: "LRW3..."
origin: LOCAL
time_fired: "2024-04-07T02:03:28.612834+00:00"
context:
  id: 01HTV4QPZ42GFHET0JW9SK9RHY
  parent_id: null
  user_id: null

Polling data

When polling, the unmodified response is emitted on the event bus, enabling you to access the data directly.

teslemetry_vehicle_data teslemetry_live_status teslemetry_site_info