Skip to main content

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

Project description

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

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)

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.25.0.tar.gz (94.1 kB view details)

Uploaded Source

Built Distribution

udsoncan-1.25.0-py3-none-any.whl (119.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: udsoncan-1.25.0.tar.gz
  • Upload date:
  • Size: 94.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.10.12

File hashes

Hashes for udsoncan-1.25.0.tar.gz
Algorithm Hash digest
SHA256 78ec1ab1b07acb2430f80a759b0b2608fc13d1bc4a150f38f1b890dba407bee1
MD5 36845a00474601673b2923a001983670
BLAKE2b-256 57d78d7ac593120e639f2f64a3a86533fd0abd6c01b14caa1095c067508559f3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: udsoncan-1.25.0-py3-none-any.whl
  • Upload date:
  • Size: 119.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.10.12

File hashes

Hashes for udsoncan-1.25.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bfccf4214fd44057eb66c1a0d0da663168de06a3748b1bc8f31680e6f210127b
MD5 93e3268b99d4d8824301b3ce13e2feab
BLAKE2b-256 e3035449ad2557b55fd824f1b3ef565789bf35e32c121d109439227f88d9b9f9

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