Repository files navigation

CLI alternative to Stellantis (Peugeot / Citroën / DS / Opel) update applications for car infotainment system (NAC / RCC firmware and navigation maps), hopefully more robust.

psa-update offers mostly the same features as the official firmware/map update application proposed by the car vendor, except that it does not format the USB flash drice that has to be used to upload the firmware/map update to the car.

Updates are exclusively downloaded from the official Stellantis website.

Features:

• Download updates of RCC / NAC firmwares, and navigation maps (NAC only)
• Resume downloads in case of failure
• Prepares USB flash drive for car infotainment system update
• Lightweight self-contained executable that can run on multiple platforms: Windows, Linux, MacOS

The command line executable can be invoked in a terminal:

$ psa-update

This will interactively ask for vehicle VIN, check for available NAC/RCC/map updates, and extract updates to a USB flash drive.

Once copied to the USB drive, the update can be applied on the car infotainment system following stellantis instructions.

For exemple for Peugeot:

• RCC instructions
• NAC instructions

For the transfer of updates to the car, a USB flash drive is required:

• Recommended size is32 GB. Although most updates are smaller than 16 GB, some navigations maps can be larger than 16 GB.
• It must be formatted asFAT32 andempty.

Note: When using Windows, if the USB flash drive is larger than 32 GB, it is not possible to format it using FAT32. Alternatives are:

• Create a 32 GB partition and format if as FAT32 and leave the rest unformatted.
• Use a third-party tool to format the USB flash drive using FAT32. The official vendor application presumably usesfat32format from Ridgecrop Consultants Ltd to achieve this.

On Linux, OpenSSL is required. On Windows and MacOS, nothing is required, the operating system TLS framework is used.

Binaries are available for Windows (x86-64), Linux (x86-64) and MacOS (x86-64 and AArch64/ARM64) in thereleases section.

To install, simply download and extract thepsa-update executable.

For other platforms the project can be built from source code (see below).

To build and run from source code using stable rust compiler toolchain (version 1.81+):

$ git clone https://github.com/zeld/psa-update.git$cd psa-update$ cargo build --release$ ./target/release/psa-update --version

Download of updates is possible behind a proxy provided thehttp_proxy andhttps_proxy environment variables are correctly set.

Using a Linux or MacOS terminal:

export http_proxy=<host>:<port>export https_proxy=<host>:<port>

Using a Windows CMD prompt:

SEThttp_proxy=<host>:<port>SEThttps_proxy=<host>:<port>

Logging can be enabled using theRUST_LOG variable. For exemple to enabledebug log level:

RUST_LOG="debug" ./psa-update

• Inspired from the Linux script in this Frenchforum post
• For the list of navigation maps, and associated content, this Frenchforum post
• List of firmware and map updates onthis site