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 = IsoTPConnection('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.6.tar.gz (73.8 kB view details)

Uploaded Source

Built Distribution

udsoncan-1.6-py3-none-any.whl (113.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: udsoncan-1.6.tar.gz
  • Upload date:
  • Size: 73.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.9.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.5.2

File hashes

Hashes for udsoncan-1.6.tar.gz
Algorithm Hash digest
SHA256 53b9bd68ed17495206bc5cce293ed438c56c563543a7f99de2d16728dced5df2
MD5 5edc40205a222e7d86cec9002794554b
BLAKE2b-256 c9d8797711cfab8b9077c2f13b1fbd0634ffec3906e9aab50cd35e33883e9e54

See more details on using hashes here.

File details

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

File metadata

  • Download URL: udsoncan-1.6-py3-none-any.whl
  • Upload date:
  • Size: 113.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.9.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.5.2

File hashes

Hashes for udsoncan-1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a0c4d9833136129535a0dfb5aa17d62aacbb0ea9c44048fed6f78eb6f6fbafa5
MD5 3c94c10d294f46d45021ceca610ca359
BLAKE2b-256 56c378b6a89490c73476b9a10c97d8750058f82dd4b5acf3c96e3a1ef3a8306a

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