Skip to main content

Implementation of the Unified Diagnostic Service (UDS) protocol (ISO-14229) used in the automotive industry.

Project description

python-udsoncan


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+

Installation


using pip:

pip install udsoncan

Example


import SomeLib.SomeCar.SomeModel as MyCar



import udsoncan

from udsoncan.connections import IsoTPSocketConnection

from udsoncan.client import Client

from udsoncan.exceptions import *

from udsoncan.services import *



udsoncan.setup_logging()



conn = IsoTPSocketConnection('can0', 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)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

udsoncan-1.15.tar.gz (103.3 kB view hashes)

Uploaded source

Built Distribution

udsoncan-1.15-py3-none-any.whl (134.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page