HomeAssistant - Stellantis Vehicles

• Requirements
• Features
• Installation
• OAuth2 Code
• Screenshot
• Commands
• Battery capacity / residual sensors
• Errors
• ABRP - A Better Routeplanner
• Support the project

Currently only PSA vehicles are compatibile.

Peugeot	Citroën	DS	Opel	Vauxhall

Requirements

Get status:

• Vehicle native mobile app installed and active;
• Use a pc for autentication;

Send remote commands:

• Get status requirements;
• Remote service actived (E-remote or Connect Plus);

Currently Stellantis not provide B2C api credentials, this integration use the mobile apps api credentials and login flow.

Features

	Electric / Hybrid	Thermic	E-remote control	Remote control	Connect Plus
Get status	✔️	✔️	✔️		✔️
Wake up	✔️	✔️	✔️		✔️
ABRP sync	✔️	✔️	✔️		✔️
Preconditioning start/stop	✔️	✔️	✔️		✔️
Doors open/close	✔️	✔️		✔️	✔️
Flash lights	✔️	✔️		✔️	✔️
Honk the horn	✔️	✔️		✔️	✔️
Charging start/stop	✔️		✔️		✔️
Charging limit	✔️		✔️		✔️

Installation

Using HACS

1. Go to HACS section;
2. Search and install Stellantis Vehicles from the HACS integration list;
3. Add this integration from the Home Assistant integrations.

Manually

1. Download this repository;
2. Copy the directory custom_components/stellantis_vehicles on your Home Assistant config/custom_components/stellantis_vehicles;
3. Restart HomeAssistant;
4. Add this integration from the Home Assistant integrations.

OAuth2 Code

Using browser console

As described on config flow, please get the right code from the mobile app redirect like this example (Chrome browser):

Using python tool

Thanks to @benbox69 for creating this awesome Python tool to fetch oauth code without using browser console: stellantis-oauth-helper

Screenshot

Commands

WakeUp

For some vehicles no updates are received a few minutes after the engine is turned off. Use automations like these to schedule the vehicle wake up:

- id: "standby_wakeup"
  alias: Vehicle standby WakeUp (every 1 hour)
  description: ""
  mode: single
  triggers:
    - trigger: time_pattern
      hours: /1
  conditions:
    - condition: state
      entity_id: binary_sensor.#####VIN#####_battery_charging
      state: "off"
  actions:
    - action: button.press
      metadata: {}
      data: {}
      target:
        entity_id: button.#####VIN#####_wakeup

- id: "charging_wakeup"
  alias: Vehicle charging WakeUp (every 5 minutes)
  description: ""
  mode: single
  triggers:
    - trigger: time_pattern
      minutes: /5
  conditions:
    - condition: state
      entity_id: binary_sensor.#####VIN#####_battery_charging
      state: "on"
  actions:
    - action: button.press
      metadata: {}
      data: {}
      target:
        entity_id: button.#####VIN#####_wakeup

* the entity names above are in english, please use your language entity names.

Some users report that performing too many wakeups drains the service battery, making some features unavailable (such as keyless entry).

Air conditioning Start/Stop

As described in the Stellantis apps, the command is enabled when:

1. The vehicle engine is off;
2. The vehicle doors are locked;
3. The battery level is at least 50% (20% for hybrids) 20% or in charging (#226);

Battery capacity / residual sensors

Thanks to the community (#272), it seems that for some vehicles Stellantis provides incorrect values. The switch.battery_values_correction entity (in your language) applies a correction if active.

*currently only to the battery_residual sensor

Errors

Before any issue request, please check the integration log and look for solution below.

OTP error - NOK:MAXNBTOOLS

It seems that this error is due to reaching the limit of associated devices / SMS received. Restore your Stellantis account and try again: Follow this procedure from Peugeot community.

This operation removes the devices connected to your vehicle, no vehicle data will be lost.

OTP error - NOK:NOK_BLOCKED

It seems that this error is due to reaching the limit of wrong PIN used. Re-authenticate the integration.

ABRP - A Better Routeplanner

Get a token from ABRP:

1. Login to your account;
2. Navigate to vehicle settings;
3. Navigate to real time data;
4. Navigate to edit connections;
5. Generate a token using "Generic" method;

Use the generated token in abrp_token sensor and enable abrp_sync switch to send updates.

Contributors & Translations

Start from the "develop" branch and submit PRs in that branch.

Commit messages are included as release notes, please keep them short and understandable.

Before each PR please test:

• New installation;
• Reconfiguration;
• Commands;
• Sensors;
• 1 week without errors in logs;

If the checklist is complete, the PR will be merged and will be released a BETA version, if no issues are reported the changes will included on next stable release.

Thanks to all users who contribute to this integration by updating translations and reporting issues.

Special thanks:

• @MoellerDi for the great work and big support;
• @benbox69 for the python oauth2 helper tool;
• @khenderick for the great work and big support;

Thanks to everyone for the issues, especially to:

• @chmtc94;
• @FrankTub;
• @Jordan87;

Support the project

The latest heroes who believe in my projects 👇

🏆 5 beers
Philipp B. / tamcore
wech71
Juraj

🥈 3 beers
Pekka
Gerhard
Simon Hunt
_{and other heroes}

🥉 2 beers
Grosi001

⭐ 1 beers
@bgoncal2
Max
Dave
_{and other heroes}

Want to join the Club?