The audiconnect component offers integration with the Audi connect cloud service and offers presence detection as well as sensors such as range, mileage, and fuel level.
Note that certain functions may require special permissions from Audi, such as the position update via GPS.
To use the audiconnect component in your installation, copy this repository into your home
assistant configuration at <config dir>/custom_components.
Add the following to your <config dir>/configuration.yaml file.
audiconnect:
username: <username to audiconnect>
password: <password to audiconnect>
scan_interval:
minutes: 2
name:
wvw1234567812356: 'Audi Q7'username
- (string)(Required)The username associated with your Audi Connect account.
password
- (string)(Required)The password for your given Audi Connect account.
region
- (string)(Optional)The region where the Audi account is registered. Set to 'DE' for Europe (or leave unset), set to 'US' for North America. May need to be set for China.
name
- (string)(Optional)Make it possible to provide a name for the vehicles. Note: Use all lower case letters when inputing your VIN number.
resources
- (list)(Optional)A list of resources to display (defaults to all available). Default value: false
scan_interval
- specify in minutes how often to fetch status data from Audi Connect (optional, default 10 min, minimum 1 min)
name
- set a friendly name of your car you can use the name setting as in confiugration example.
refresh_vehicle_data
The normal update procedure retrieves the data from the servers and does not directly interact with the vehicle. This service triggers an update request from the vehicle. When the data is retrieved successfully, the data in Home Assistant is automatically updated. The service requires a vin as parameter.
Below is an example Lovelace Card summarizing some of the sensors this Home Assistant addon provides.
The card uses the following code in ui-lovelace.yaml.
- type: custom:card-modder
style:
border-radius: 20px
border: solid 1px rgba(100,100,100,0.3)
box-shadow: 3px 3px rgba(0,0,0,0.4)
overflow: hidden
card:
type: picture-elements
image: /local/pictures/audi_sq7.jpeg
elements:
- type: image
image: /local/pictures/cardbackK.png
style:
left: 50%
top: 90%
width: 100%
height: 60px
- type: icon
icon: mdi:car-door
entity: sensor.audi_sq7_doors_trunk_state
tap_action: more_info
style: {color: white, left: 10%, top: 86%}
- type: state-label
entity: sensor.audi_sq7_doors_trunk_state
style: {color: white, left: 10%, top: 95%}
- type: state-icon
entity: sensor.windows_sq7
tap_action: more_info
style: {color: white, left: 30%, top: 86%}
- type: state-label
entity: sensor.windows_sq7
style: {color: white, left: 30%, top: 95%}
- type: icon
icon: mdi:oil
entity: sensor.audi_sq7_oil_level
tap_action: more_info
style: {color: white, left: 50%, top: 86%}
- type: state-label
entity: sensor.audi_sq7_oil_level
style: {color: white, left: 50%, top: 95%}
- type: icon
icon: mdi:room-service-outline
entity: sensor.audi_sq7_service_inspection_time
tap_action: more_info
style: {color: white, left: 70%, top: 86%}
- type: state-label
entity: sensor.audi_sq7_service_inspection_time
style: {color: white, left: 70%, top: 95%}
- type: icon
icon: mdi:speedometer
entity: sensor.audi_sq7_mileage
tap_action: more_info
style: {color: white, left: 90%, top: 86%}
- type: state-label
entity: sensor.audi_sq7_mileage
style: {color: white, left: 90%, top: 95%}
- type: custom:circle-sensor-card
entity: sensor.audi_sq7_tank_level
max: 100
min: 0
stroke_width: 15
gradient: true
fill: '#aaaaaabb'
name: tank
units: ' '
font_style:
font-size: 1.0em
font-color: white
text-shadow: '1px 1px black'
style:
top: 5%
left: 85%
width: 4em
height: 4em
transform: none
- type: custom:circle-sensor-card
entity: sensor.audi_sq7_range
max: 650
min: 0
stroke_width: 15
gradient: true
fill: '#aaaaaabb'
name: range
units: ' '
font_style:
font-size: 1.0em
font-color: white
text-shadow: '1px 1px black'
style:
top: 5%
left: 5%
width: 4em
height: 4em
transform: none