PyPSADiag

IMPORTANT!

This application is as is, and you use it at your own risk.
I am not responsible for any damages or injuries resulting from the use of this application.
VERY IMPORTANT: This application is for educational purposes only and should be used with care!.

---

PyPSADiag is an Python application for sending diagnostic frames over CAN-BUS to PSA/Stellantis based cars
See for additional Hardware/Info: ludwig-v arduino-psa-diag

Currently supporting:

• JSON Configuration for example BSI2010 to setup GUI
  See more JSON Configuration Files
• Reading Zones that are listed in JSON Configuration file
• Saving Zones to CSV file
• Saving changed Zones (as an list) to ECU
• Flashing of CAL and ULP Files to ECU

What I would like to support:

• More ECU JSON Files

Need Help?

If you need some help, try to look at the Wiki

Help the Project

Help in any way is appreciated, just send me an email with anything you can contribute to the project, like:

• More ECU JSON Files
• Python coding
• GUI design
• ideas / feature requests
• test reports
• spread the word!

Use a Release

• Get release a from Download Release There is Windows, Linux and macOS versions
• Extract archive to your hardrive
• Run with PyPSADiag-windows.exe or any other distibution you downloaded:
  1. PyPSADiag-windows.exe --lang nl
  2. Open Zone File and select an ECU JSON file
  3. Connect to correct Arduino hardware
  4. Read Zones
  5. RISK: You can save the Zones to the ECU by using the Write Button.
     Always Check that these zones look correct

Build Yourself

To build and run PyPSADiag locally:

• Install Python: Make sure you have Python 3.12 or newer installed.
  You can check with: python --version
• Get the code: Clone the repository: git clone https://github.com/Barracuda09/PyPSADiag.git
  OR use this Download ZIP
• Enter the project directory: cd /path/to/PyPSADiag
• Create a virtual environment: python -m venv .venv --prompt PyPSADiag
• Activate your virtual environment:
  for Windows: /path/to/PyPSADiag/.venv/Script/activate
  for Linux/MacOS: source .venv/Script/activate
• Install required dependencies, within the path of PyPSADiag: pip install -r requirements.txt
• Run with:
  1. python main.py --lang nl
  2. Open Zone File and select an ECU JSON file
  3. Connect to correct Arduino hardware
  4. Read Zones
  5. RISK: You can save the Zones to the ECU by using the Write Button.
     Always Check that these zones look correct
• On MacOs app bundle will be blocked because it’s unsigned. If you see a security warning, allow it via:
  System Settings → Privacy & Security → Allow Anyway
  Note:
  On macOS, the packaged .app will place resources inside the Contents/Resources directory, following Apple’s bundle structure.

CAL/ULP File Information

To show information of a CAL or ULP File.

• Run with one of these:
  1. python DecodeCalUlpFile.py --path ulp/9698105080.ulp Show only S0 and S1 records
  2. python DecodeCalUlpFile.py --all --path cal/9694212680.cal Show All S records

Make Translations

For example to make a translation for Dutch use this command:

• i18n/Languages.json Add the language code and name
• i18n/flags/nl.png Add the .PNG flag for this language (About 128 x 84 Pixels)
• python buildi18n.py --lang nl --> Build the qt.ts file
• python translate.py --input ./i18n/PyPSADiag_nl.qt.ts --> Google Translate
• pyside6-linguist ./i18n/PyPSADiag_translated_nl.qt.ts --> Correct translation if required
• python translate.py --releaseonly --input ./i18n/PyPSADiag_nl.qt.ts --> Only Release translation qm file
• python main.py --lang nl --> Run with nl language

Donate

If you like my work then please consider making a donation, to support my effort in developing this application.
Many thanks to all who donated already.

PayPal

Contact

If you like to contact me, you can do so by sending an email to:

mpostema09 -at- gmail.com