home-assistant.io/source/_integrations/mazda.markdown

title, description, ha_release, ha_category, ha_iot_class, ha_quality_scale, ha_config_flow, ha_codeowners, ha_domain, ha_platforms

title	description	ha_release	ha_category	ha_iot_class	ha_quality_scale	ha_config_flow	ha_codeowners	ha_domain	ha_platforms
Mazda Connected Services	Instructions on how to integrate your Connected Services capable Mazda vehicle with Home Assistant.	2021.3	Car Lock Presence Detection Sensor	Cloud Polling	platinum	true	@bdr99	mazda	device_tracker lock sensor

The Mazda Connected Services integration allows you to retrieve data from a Mazda vehicle. In order to use this integration, you must first register your vehicle using the MyMazda app (iOS/Android).

This integration requires an active Mazda Connected Services subscription and a compatible vehicle. The following Mazda vehicles are Mazda Connected Services capable:

• Mazda3: 2019+
• CX-30: 2020+
• CX-9: 2021+
• CX-5: 2021+

{% include integrations/config_flow.md %}

The MyMazda API only allows one active session at a time. Therefore, if you use the same account with both Home Assistant and the MyMazda mobile app, you may experience issues ("Multiple devices detected" notifications, session expired warnings, etc.) To fix this, you can create a secondary MyMazda account, and share your vehicle with the secondary account. Log in to the mobile app using the primary account and select Menu > MyMazda > My Vehicle > Drivers > Manage Drivers > Invite Driver. When finished, log into the secondary account with Home Assistant.

Platforms

Sensor

The following sensor entities are available:

• Fuel remaining
• Fuel distance remaining
• Odometer
• Tire pressure (not available for CX-5 and CX-9 models)

Device tracker

Tracks the current location of the vehicle. This will generally update when the vehicle is switched off.

Lock

Displays the current door lock status of the vehicle, and locks/unlocks the doors of the vehicle.

The "Automatic Re-Lock" feature will automatically re-lock the doors if they are not opened shortly after being unlocked. This applies regardless of whether you are using the key, or unlocking the doors remotely using Home Assistant or the MyMazda app.

Services

This integration offers several services for interacting with Mazda vehicles.

Service mazda.start_engine

Starts the vehicle engine. The vehicle engine can only be remotely started 2 consecutive times. To reset this counter, the vehicle must be driven.

Service Data Attribute	Required	Description
device_id	yes	The device ID of the vehicle to start

Service mazda.stop_engine

Stops the vehicle engine. This only works if the vehicle was remotely started.

Service Data Attribute	Required	Description
device_id	yes	The device ID of the vehicle to stop

Service mazda.start_charging

Starts charging the vehicle battery. This only works with electric vehicles.

Service Data Attribute	Required	Description
device_id	yes	The device ID of the vehicle to start charging

Service mazda.stop_charging

Stops charging the vehicle battery. This only works with electric vehicles.

Service Data Attribute	Required	Description
device_id	yes	The device ID of the vehicle to stop charging

Service mazda.send_poi

Send a GPS location to the vehicle's navigation system as a POI (Point of Interest). Requires a navigation SD card installed in the vehicle.

Service Data Attribute	Required	Description
device_id	yes	The device ID of the vehicle to send the GPS location to
latitude	yes	The latitude of the location to send.
longitude	yes	The longitude of the location to send.
poi_name	yes	A friendly name for the location.

Service mazda.turn_on_hazard_lights

Turn on the vehicle hazard lights. The lights will flash briefly and then turn off.

Service Data Attribute	Required	Description
device_id	yes	The device ID of the vehicle to turn hazard lights on

Service mazda.turn_off_hazard_lights

Temporarily turn off the vehicle hazard lights if they have been manually turned on from inside the vehicle. If a door is opened, the hazard lights will turn back on.

Service Data Attribute	Required	Description
device_id	yes	The device ID of the vehicle to turn hazard lights off

Disclaimer

This integration is not affiliated with or endorsed by Mazda.