Remote Control of PSA car

This is a python program to control and get information from a PSA car.

I test it with a Peugeot e-208, but it works with others PSA vehicles (Citroen, Opel, Vauxhall, DS).

With this app you will be able to :

get the status of the car (battery level for electric vehicle, position ... )
start and stop the charge
set a charge threshold to limit the battery level to a certain percentage
set a stop hour to charge your vehicle only on off-peak hours
control air conditioning
control lights and horn if your vehicle is compatible (mine isn't)
get consumption statistic
visualize your trips on a map or in a table
get the list of car charging
visualize battery charging curve
visualize altitude trip curve
get car charging co2 emission
get car charging price
send live data to ABetterRoutePlanner

The official api is documented here but it is not totally up to date, and contains some errors.

I. Installation

II. Use the app

2.1 Get the car state :
http://localhost:5000/get_vehicleinfo/YOURVIN

2.2 Get the car state from cache to avoid to use psa api too much
http://localhost:5000/get_vehicleinfo/YOURVIN?from_cache=1

2.2 Stop charge
http://localhost:5000/charge_now/YOURVIN/0

2.3 Set hour to stop the charge to 6am
http://localhost:5000/charge_control?vin=yourvin&hour=6&minute=0 

2.4 Change car charge threshold to 80 percent
http://localhost:5000/charge_control?vin=YOURVIN&percentage=80 

2.5 See the dashboard (only if record is enabled)
http://localhost:5000

2.6 Refresh car state (ask car to send its state):
http://localhost:5000/wakeup/YOURVIN

2.7 Start/Stop preconditioning
http://localhost:5000/preconditioning/YOURVIN/1 or 0

2.8 Change charge hour (for example: set it to 22h30)
http://127.0.0.1:5000/charge_hour?vin=YOURVIN&hour=22&minute=30

III. Use the dashboard

You can add the -r argument to record the position of the vehicle and retrieve this information in a dashboard.

python3 psa-car-controller -f config.json -c charge_config.json -r

You will be able to visualize your trips, your consumption and some statistics:

You have to add an api key from https://home.openweathermap.org/ in your config file, to be able to see your consumption vs exterior temperature.
You have to add an api key from https://co2signal.com/ to have your C02 emission by KM (in France the key isn't needed).

IV. Charge price calculation

The dashboard can give you the price by kilometer and price by kw that you pay. You just have to set the price in the config file.

After a successful launch of the app, a config.ini file will be created. In this file you can set the price you pay for electricity in the following format "0.15".

If you have a special price during the night you can set "night price", "night hour start" and "night hour end". Hours need to be in the following format "23h12"?

You can modify a price manually in the dashboard. It can be useful if you use public charge point.

V. Connection to other services:

Domoticz
HomeAssistant
Jeedom (Anyone can share the procedure ?)
You can send live car status to ABRP (A better Route Planner), see this page
Grafana

FAQ

If you have a problem, or a question please check if the answer isn't in the FAQ.

Contribute

If you need information to contribute or edit this program go here.

Donation

If you want to thank me for my work 😄

Reiderade/Docker-Car