Add documentation about device tracker platform for Mazda integration (#17019)

This commit is contained in:
Brandon Rothweiler 2021-04-17 06:45:29 -04:00 committed by GitHub
parent c7ba928de3
commit b1772c38c9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -4,6 +4,7 @@ description: Instructions on how to integrate your Connected Services capable Ma
ha_release: '2021.3' ha_release: '2021.3'
ha_category: ha_category:
- Car - Car
- Presence Detection
- Sensor - Sensor
ha_iot_class: Cloud Polling ha_iot_class: Cloud Polling
ha_quality_scale: platinum ha_quality_scale: platinum
@ -12,6 +13,7 @@ ha_codeowners:
- '@bdr99' - '@bdr99'
ha_domain: mazda ha_domain: mazda
ha_platforms: ha_platforms:
- device_tracker
- sensor - sensor
--- ---
@ -24,21 +26,12 @@ This integration requires an active Mazda Connected Services subscription and a
- CX-9: 2021+ - CX-9: 2021+
- CX-5: 2021+ - CX-5: 2021+
Currently, this integration only provides the Sensor platform. The following sensors are supported: This integration provides the following platforms:
- Fuel Percentage Remaining - Sensor: Fuel remaining, fuel distance remaining, odometer, and tire pressure. Tire pressure is not available for CX-5 and CX-9 models.
- Fuel Distance Remaining - Device tracker: Tracks the current location of the vehicle. This updates when the vehicle is switched off.
- Odometer
- Front Left Tire Pressure
- Front Right Tire Pressure
- Rear Left Tire Pressure
- Rear Right Tire Pressure
## Configuration {% include integrations/config_flow.md %}
To enable the Mazda Connected Services integration, go to **Configuration** > **Integrations** > **Add Integration** > **Mazda Connected Services**.
Enter the same email address and password that you would use to sign into the MyMazda mobile app. Select your region, and click **Submit**.
<div class='note warning'> <div class='note warning'>
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. 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.