Skip to main content

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

Project description

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 IsoTPConnection
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.8.tar.gz (77.4 kB view details)

Uploaded Source

Built Distribution

udsoncan-1.8-py3-none-any.whl (107.3 kB view details)

Uploaded Python 3

File details

Details for the file udsoncan-1.8.tar.gz.

File metadata

  • Download URL: udsoncan-1.8.tar.gz
  • Upload date:
  • Size: 77.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for udsoncan-1.8.tar.gz
Algorithm Hash digest
SHA256 beb34bf11c229131c2e87fd0e0263b91787913e79d8462408e8cb04666351e8b
MD5 595e5703076859af6f05faa074c18d86
BLAKE2b-256 c2215a72a2ad392a802c11f53884b5825b0c5c17ea469c44b2b550dcf88c0808

See more details on using hashes here.

File details

Details for the file udsoncan-1.8-py3-none-any.whl.

File metadata

  • Download URL: udsoncan-1.8-py3-none-any.whl
  • Upload date:
  • Size: 107.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for udsoncan-1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 c71195d3a8fa10f0b17fb13d705c0dd2a37c1100855d95e6c3fede3e8fef3c3b
MD5 e4352041d5e9cbccc382eb85b8fe5baf
BLAKE2b-256 b51a0ea57ac011d4d9cbd020551097f401d8cd5d8348e46a6a347ced07d50860

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page