Renault

The Renault integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] connects your Renault, Dacia, or Alpine vehicle to Home Assistant through the My Renault cloud service. It uses the same account as the My Renault app on your phone.

For example, you can:

• See the battery level, range, charge state, and mileage of your vehicle on your dashboard.
• Get notified when charging is complete.
• Pre-heat or pre-cool the cabin before you leave in the morning.
• Start or stop charging, or set battery charge limits, based on your energy prices.
• Track the location of your vehicle.

Supported devices

The integration works with vehicles that are linked to a My Renault account. The features available depend on the vehicle model, and some features require a subscription. The following models are known to work:

• Renault: 4 E-Tech, 5 E-Tech, Arkana E-Tech, Austral, Captur II, Clio V, Espace VI, Master E-Tech, Megane IV, Megane E-Tech, Rafale, Scenic E-Tech, Symbioz, Twingo III Z.E., Zoe
• Dacia: Bigster, Duster III, Sandero III, Spring
• Alpine: A290

Other models linked to a My Renault account may also work. In that case, the integration uses a default set of features and writes a message to the log.

Prerequisites

• A My Renault account with your vehicle linked to it. If you can see your vehicle in the My Renault app, the integration can access it.
• The email address and password you use to sign in to the My Renault app.
• If two-factor authentication is turned on for your My Renault account, access to the email inbox that receives the verification codes.
• For remote control features, such as starting the air conditioning or charging, your vehicle might need an active subscription, such as the Pack EV Remote Control or the Pack Smart Navigation.

Configuration

To add the Renault hub to your Home Assistant instance, use this My button:

If two-factor authentication is turned on for your My Renault account, Home Assistant asks for a verification code after you enter your password:

1. If more than one email address is registered for two-factor authentication, select the address to send the code to.
2. Enter the Verification code that Renault sent to that address.

Home Assistant then remembers the device, so you do not need a new code each time Home Assistant starts.

If your email address is linked to more than one Kamereon account, Home Assistant asks you to select the account your vehicles are assigned to. If there is only one account, it is selected automatically.

The integration entry is named after your masked email address, for example e***@example.com. Each vehicle linked to the account is added as a device, named after its registration number.

To change the locale, email address, or password later, go to Settings > Devices & services, select Renault, then select the three dots menu next to the entry, and select Reconfigure. You must select the same Kamereon account. If two-factor authentication is turned on, Home Assistant can ask for a new verification code.

Supported functionality

The Renault integration provides the following entities. The entities available for your vehicle depend on its model, whether it is electric, hybrid, or fuel-powered, and your subscription. The integration only creates entities for the features that your vehicle supports.

On the device page, the Minimum charge level and Target charge level numbers and the Charge mode select are shown under Configuration. The Charging mode, HVAC SoC threshold, Last battery activity, Last HVAC activity, Last location activity, and Remote engine start code sensors are shown under Diagnostic.

Binary sensors

• Charging
  • Description: Whether the vehicle is charging
  • Available for: Electric and plug-in hybrid vehicles
• Plug
  • Description: Whether the charging cable is plugged in
  • Available for: Electric and plug-in hybrid vehicles
• HVAC
  • Description: Whether the air conditioning is running
• Lock
  • Description: Whether the vehicle is locked or unlocked
• Driver door, Passenger door, Rear left door, Rear right door, and Hatch
  • Description: Whether each door or the hatch is open

Buttons

• Start air conditioner
  • Description: Starts the air conditioning at 21°C
  • Remarks: To use another temperature or start time, use the Start A/C action
• Start charge and Stop charge
  • Description: Starts or stops charging
  • Available for: Electric and plug-in hybrid vehicles
• Flash lights
  • Description: Flashes the lights of the vehicle, for example to find it in a parking lot
• Sound horn
  • Description: Sounds the horn of the vehicle

Device tracker

• Location
  • Description: The last known GPS location of the vehicle

Numbers

• Minimum charge level
  • Description: The minimum battery charge level that the vehicle keeps, from 15% to 45% in steps of 5%
  • Available for: Electric and plug-in hybrid vehicles that support charge limits
• Target charge level
  • Description: The battery charge level at which charging stops, from 55% to 100% in steps of 5%
  • Available for: Electric and plug-in hybrid vehicles that support charge limits
  • Remarks: For example, a target of 80% can help preserve long-term battery health

Selects

• Charge mode
  • Description: How the vehicle charges when it is plugged in
  • Options: Always, Always charging, Schedule mode, Scheduled
  • Available for: Electric and plug-in hybrid vehicles

Sensors

• Battery
  • Description: The battery charge level
  • Available for: Electric and plug-in hybrid vehicles
• Battery autonomy
  • Description: The estimated electric range
  • Available for: Electric and plug-in hybrid vehicles
• Battery available energy
  • Description: The energy available in the battery
  • Available for: Electric and plug-in hybrid vehicles
• Battery temperature
  • Description: The temperature of the battery
  • Available for: Electric and plug-in hybrid vehicles
• Charge state
  • Description: The charging state, such as Not charging, Waiting for planned charge, Charging, or Charge ended
  • Available for: Electric and plug-in hybrid vehicles
• Charging mode
  • Description: The charging mode set in the vehicle: Always, Delayed, Delegated, or Scheduled
  • Available for: Electric and plug-in hybrid vehicles
• Charging power or Admissible charging power
  • Description: The current charging power, or the maximum power the vehicle accepts, depending on the model
  • Available for: Electric and plug-in hybrid vehicles
• Charging remaining time
  • Description: The time left until charging is complete
  • Available for: Electric and plug-in hybrid vehicles
• Plug state
  • Description: The state of the charging plug, such as Unplugged or Plugged in
  • Available for: Electric and plug-in hybrid vehicles
• Fuel autonomy
  • Description: The estimated fuel range
  • Available for: Fuel and hybrid vehicles
• Fuel quantity
  • Description: The amount of fuel in the tank
  • Available for: Fuel and hybrid vehicles
• Mileage
  • Description: The total distance traveled by the vehicle
• Outside temperature
  • Description: The temperature outside the vehicle
• HVAC SoC threshold
  • Description: The minimum battery SoC, in %, needed to start the air conditioning remotely
• Front left tyre pressure, Front right tyre pressure, Rear left tyre pressure, and Rear right tyre pressure
  • Description: The pressure of each tire
• Remote engine start
  • Description: The status of the last remote engine start
• Last battery activity, Last HVAC activity, and Last location activity
  • Description: When the vehicle last reported battery, air conditioning, or location data
  • Remarks: These entities are disabled by default
• Remote engine start code
  • Description: The code of the last remote engine start
  • Remarks: This entity is disabled by default

List of actions

The Renault integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Cancel A/C (renault.ac_cancel) Cancels the air conditioning of a Renault vehicle.

• Update A/C schedule (renault.ac_set_schedules) Updates the air conditioning schedules of a Renault vehicle.

• Start A/C (renault.ac_start) Starts the air conditioning of a Renault vehicle.

• Update charge schedule (renault.charge_set_schedules) Updates the charge schedules of a Renault vehicle.

• Start charging (renault.charge_start) Starts charging a Renault vehicle.

For an overview of every action across all integrations, see the actions reference.

Renault automation examples

The Renault integration lets you react to the state of your vehicle and control it from your automations. Here are some ideas to get you started.

Automation: Get notified when charging is complete

Send a notification to your phone when your vehicle finishes charging. Replace the entity IDs in the example with the entity IDs of your vehicle and phone.

• Trigger: State changed
  • Target: Your vehicle’s Charge state sensor
  • To: Charge ended
• Action: Send a notification message
  • Target: My Device (notify.my_device)

alias: "Notify when the car has finished charging"
triggers:
  - trigger: state
    entity_id: sensor.reg_number_charge_state
    to: "charge_ended"
actions:
  - action: notify.send_message
    target:
      entity_id: notify.my_device
    data:
      message: "Your car has finished charging."

Automation: Pre-heat the cabin on weekday mornings

Start the air conditioning at 19°C at 7:30 on weekdays, so the cabin is comfortable when you leave. To find the vehicle ID for the YAML example, select the vehicle in the UI editor first, then switch to YAML mode.

• Trigger: Time
  • At time: 07:30:00
  • Days of the week: Monday, Tuesday, Wednesday, Thursday, and Friday
• Action: Renault: Start A/C
  • Vehicle: abcde1234567890abcde1234567890ab
  • Temperature: 19°C

alias: "Pre-heat the car on weekday mornings"
triggers:
  - trigger: time
    at: "07:30:00"
    weekday:
      - mon
      - tue
      - wed
      - thu
      - fri
actions:
  - action: renault.ac_start
    data:
      vehicle: abcde1234567890abcde1234567890ab
      temperature: 19

Data updates

The Renault integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] the Renault servers for data. The vehicle data is split into several groups, such as battery, location, and air conditioning. The integration makes on average one request per minute, so each value is updated about every N minutes, where N is the total number of data groups across all your vehicles. For example, if your vehicle supports 6 groups, each value is updated every 6 minutes. With 2 such vehicles on the same account, each value is updated every 12 minutes.

This keeps the integration within the request limits of the Renault servers. If the servers still report that too many requests were made, the integration pauses updates for 15 minutes and keeps showing the last known values.

The integration also checks the list of vehicles in your My Renault account every hour. New vehicles are added automatically, and vehicles you removed from your account are removed from Home Assistant.

When you change a charge limit, Home Assistant shows the new value right away, before the Renault servers confirm it.

Known limitations

• The integration depends on the Renault servers and on an internet connection. It cannot connect to the vehicle directly.
• Some features require a subscription, such as the Pack EV Remote Control or the Pack Smart Navigation.
• Not all features are available on all models. For example, the horn, lights, and tire pressure are not available on many recent vehicles, and some electric vehicles cannot stop charging remotely.
• Two-factor authentication only supports verification codes sent by email.
• A vehicle that you add to your My Renault account can take up to an hour to appear in Home Assistant.
• The Start air conditioner button always uses 21°C. To use another temperature, use the Start A/C action.

Troubleshooting

Reporting an issue

When you report an issue, include a debug log and the diagnostics data:

1. Turn on debug logging for the Renault integration.
2. Reload the integration, and wait until the issue occurs again.
3. Turn off debug logging. The debug log file downloads automatically.
4. Download the diagnostics data of the integration or the vehicle.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. Next to the entry you want to remove, select the three dots menu. Then, select Delete.
   • Depending on the integration, the entries are listed under one of the following headings:
     • Devices
     • Hubs
     • Services
     • Integration entries
3. To confirm, select Delete.
   • Home Assistant also deletes the devices and entities of the entry.
4. If Home Assistant asks you to restart, restart Home Assistant.
5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
   • If you keep them, Home Assistant uses them automatically when you add the integration again.
   • To delete them later, refer to Deleting application credentials.

Removing a vehicle you no longer own

When you remove a vehicle from your My Renault account, Home Assistant removes it automatically at the next hourly check, or when you reload the integration.

If you removed all vehicles from your account, Home Assistant keeps them, because an empty list usually means a problem with the Renault servers. In that case, remove the Renault integration.