Skip to main content

MQTT Integration

The MQTT function within TeslaMate allows useful values to be published to an MQTT broker. This is useful in allowing other automation platforms to consume data from TeslaMate.

MQTT Topics

Vehicle data will be published to the following topics:

TopicExampleDescription
teslamate/cars/$car_id/display_nameBlue ThunderVehicle Name
teslamate/cars/$car_id/stateasleepStatus of the vehicle (e.g. online, asleep, charging)
teslamate/cars/$car_id/since2019-02-29T23:00:07ZDate of the last status change
teslamate/cars/$car_id/healthytrueHealth status of the logger for that vehicle
teslamate/cars/$car_id/version2019.32.12.2Software Version
teslamate/cars/$car_id/update_availablefalseIndicates if a software update is available
teslamate/cars/$car_id/update_version2019.32.12.3Software version of the available update
teslamate/cars/$car_id/model3Either "S", "3", "X" or "Y"
teslamate/cars/$car_id/trim_badgingP100DTrim badging
teslamate/cars/$car_id/exterior_colorDeepBlueThe exterior color
teslamate/cars/$car_id/wheel_typePinwheel18The wheel type
teslamate/cars/$car_id/spoiler_typeNoneThe spoiler type
teslamate/cars/$car_id/geofence🏡 HomeThe name of the Geo-fence, if one exists at the current position
teslamate/cars/$car_id/latitude35.278131DEPRECATED: Last reported car latitude
teslamate/cars/$car_id/longitude29.744801DEPRECATED: Last reported car longitude
teslamate/cars/$car_id/location
{
"latitude": 35.278131,
"longitude": 29.744801
}
Last reported car location (json blob)
teslamate/cars/$car_id/shift_stateDCurrent/Last Shift State (D/N/R/P)
teslamate/cars/$car_id/power-9Current battery power in watts. Positive value on discharge, negative value on charge
teslamate/cars/$car_id/speed12Current Speed in km/h
teslamate/cars/$car_id/heading340Last reported car direction
teslamate/cars/$car_id/elevation70Current elevation above sea level in meters
teslamate/cars/$car_id/lockedtrueIndicates if the car is locked
teslamate/cars/$car_id/sentry_modefalseIndicates if Sentry Mode is active
teslamate/cars/$car_id/windows_openfalseIndicates if any of the windows are open
teslamate/cars/$car_id/doors_openfalseIndicates if any of the doors are open
teslamate/cars/$car_id/driver_front_door_openfalseIndicates if the driver-side front door is open
teslamate/cars/$car_id/driver_rear_door_openfalseIndicates if the driver-side rear door is open
teslamate/cars/$car_id/passenger_front_door_openfalseIndicates if the passenger-side front door is open
teslamate/cars/$car_id/passenger_rear_door_openfalseIndicates if the passenger-side rear door is open
teslamate/cars/$car_id/trunk_openfalseIndicates if the trunk is open
teslamate/cars/$car_id/frunk_openfalseIndicates if the frunk is open
teslamate/cars/$car_id/is_user_presentfalseIndicates if a user is present in the vehicle
teslamate/cars/$car_id/is_climate_ontrueIndicates if the climate control is on
teslamate/cars/$car_id/inside_temp20.8Inside Temperature in °C
teslamate/cars/$car_id/outside_temp18.4Temperature in °C
teslamate/cars/$car_id/is_preconditioningfalseIndicates if the vehicle is being preconditioned
teslamate/cars/$car_id/odometer1653Car odometer in km
teslamate/cars/$car_id/est_battery_range_km372.5Estimated Range in km
teslamate/cars/$car_id/rated_battery_range_km401.63Rated Range in km
teslamate/cars/$car_id/ideal_battery_range_km335.79Ideal Range in km
teslamate/cars/$car_id/battery_level88Battery Level Percentage
teslamate/cars/$car_id/usable_battery_level85Usable battery level percentage
teslamate/cars/$car_id/plugged_intrueIf car is currently plugged into a charger
teslamate/cars/$car_id/charge_energy_added5.06Last added energy in kWh
teslamate/cars/$car_id/charge_limit_soc90Charge Limit Configured in Percentage
teslamate/cars/$car_id/charge_port_door_opentrueIndicates if the charger door is open
teslamate/cars/$car_id/charger_actual_current2.05Current amperage supplied by charger
teslamate/cars/$car_id/charger_phases3Number of charger power phases (1-3)
teslamate/cars/$car_id/charger_power48.9Charger Power
teslamate/cars/$car_id/charger_voltage240Charger Voltage
teslamate/cars/$car_id/charge_current_request40How many amps the car wants
teslamate/cars/$car_id/charge_current_request_max40How many amps the car can have
teslamate/cars/$car_id/scheduled_charging_start_time2019-02-29T23:00:07ZStart time of the scheduled charge
teslamate/cars/$car_id/time_to_full_charge1.83Hours remaining to full charge
teslamate/cars/$car_id/tpms_pressure_fl2.9Tire pressure measure in BAR, front left tire
teslamate/cars/$car_id/tpms_pressure_fr2.8Tire pressure measure in BAR, front right tire
teslamate/cars/$car_id/tpms_pressure_rl2.9Tire pressure measure in BAR, rear left tire
teslamate/cars/$car_id/tpms_pressure_rr2.8Tire pressure measure in BAR, rear right tire
teslamate/cars/$car_id/tpms_soft_warning_fltrueIndicates if the Tire pressure measure is soft warning, front left tire
teslamate/cars/$car_id/tpms_soft_warning_frfalseIndicates if the Tire pressure measure is soft warning, front right tire
teslamate/cars/$car_id/tpms_soft_warning_rlfalseIndicates if the Tire pressure measure is soft warning, rear left tire
teslamate/cars/$car_id/tpms_soft_warning_rrfalseIndicates if the Tire pressure measure is soft warning, rear right tire
teslamate/cars/$car_id/active_route_destinationHomeDEPRECATED: Navigation destination name (or "nil")
teslamate/cars/$car_id/active_route_latitude35.278131DEPRECATED: Navigation destination latitude (or "nil")
teslamate/cars/$car_id/active_route_longitude29.744801DEPRECATED: Navigation destination longitude (or "nil")
teslamate/cars/$car_id/active_routeSee belowNavigation details (json blob)
teslamate/cars/$car_id/center_display_state0Center Display State
note

$car_id usually starts at 1

active_route payload examples

Routing to a destination.

{
"destination": "Home",
"energy_at_arrival": 73,
"miles_to_arrival": 6.485299,
"minutes_to_arrival": 23.466667,
"traffic_minutes_delay": 0.0,
"location": {
"latitude": 35.278131,
"longitude": 29.744801
},
"error": null
}

Not routing to a destination.

{
"error": "No active route available"
}