https://github.com/pylessard/python-udsoncan

Python implementation of UDS (ISO-14229) standard.
https://github.com/pylessard/python-udsoncan

14229 15765 automotive can can-bus canbus car controller-area-network diagnostic diagnostic-tool iso-14229 iso-15765 iso-tp iso14229 iso15765 isotp obd2 python uds vehicle-diagnostic

Last synced: 28 days ago
JSON representation

Python implementation of UDS (ISO-14229) standard.

• Host: GitHub
• URL: https://github.com/pylessard/python-udsoncan
• Owner: pylessard
• License: mit
• Created: 2017-08-06T02:40:37.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-10-29T13:09:12.000Z (about 1 month ago)
• Last Synced: 2024-10-29T15:57:02.753Z (about 1 month ago)
• Topics: 14229, 15765, automotive, can, can-bus, canbus, car, controller-area-network, diagnostic, diagnostic-tool, iso-14229, iso-15765, iso-tp, iso14229, iso15765, isotp, obd2, python, uds, vehicle-diagnostic
• Language: Python
• Homepage:
• Size: 960 KB
• Stars: 586
• Watchers: 38
• Forks: 201
• Open Issues: 7
• Metadata Files:
  • Readme: README.rst
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-canbus - python-UDSonCAN - Python implementation of UDS ISO-14229 standard. (Protocols / UDS)

README

        
python-udsoncan

###############

.. image:: https://app.travis-ci.com/pylessard/python-udsoncan.svg?branch=master

This project is an implementation of the Unified Diagnostic Services (UDS) protocol defined by ISO-14229 written in Python 3. The code is published under MIT license on GitHub (pylessard/python-udsoncan).

Documentation

-------------

The documentation is available here :   http://udsoncan.readthedocs.io

Requirements

------------

 - Python 3.7+

Installation

------------

using pip::

    pip install udsoncan

Example

-------

.. code-block:: python

   import SomeLib.SomeCar.SomeModel as MyCar

   import udsoncan

   import isotp

   from udsoncan.connections import IsoTPSocketConnection

   from udsoncan.client import Client

   from udsoncan.exceptions import *

   from udsoncan.services import *

   

   udsoncan.setup_logging()

   

   conn = IsoTPSocketConnection('can0', isotp.Address(isotp.AddressingMode.Normal_11bits, rxid=0x123, txid=0x456))

   with Client(conn,  request_timeout=2, config=MyCar.config) as client:

      try:

         client.change_session(DiagnosticSessionControl.Session.extendedDiagnosticSession)  # integer with value of 3

         client.unlock_security_access(MyCar.debug_level)   # Fictive security level. Integer coming from fictive lib, let's say its value is 5

         client.write_data_by_identifier(udsoncan.DataIdentifier.VIN, 'ABC123456789')       # Standard ID for VIN is 0xF190. Codec is set in the client configuration

         print('Vehicle Identification Number successfully changed.')

         client.ecu_reset(ECUReset.ResetType.hardReset)  # HardReset = 0x01

      except NegativeResponseException as e:

         print('Server refused our request for service %s with code "%s" (0x%02x)' % (e.response.service.get_name(), e.response.code_name, e.response.code))

      except (InvalidResponseException, UnexpectedResponseException) as e:

         print('Server sent an invalid payload : %s' % e.response.original_payload)