python-udsoncan

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)

Metadata

Release files for udsoncan 1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for udsoncan 1.6
File	Size	Uploaded
udsoncan-1.6.tar.gz	73.8 kB	Nov 28, 2018	Details

Built distribution (wheel)

Table of built distributions (wheels) for udsoncan 1.6
File	Interpreter	ABI	Platform	Reset
udsoncan-1.6-py3-none-any.whl 113.1 kB Nov 28, 2018	Python 3	none	any	Details

Total release size: 186.9 kB

Release files / udsoncan-1.6.tar.gz

Download URL	udsoncan-1.6.tar.gz
Size	73.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`53b9bd68ed17495206bc5cce293ed438c56c563543a7f99de2d16728dced5df2`
BLAKE2b-256 checksum How to use checksums	`c9d8797711cfab8b9077c2f13b1fbd0634ffec3906e9aab50cd35e33883e9e54`
Upload date	Nov 28, 2018
Uploaded using Trusted Publishing? What is 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`

Release files / udsoncan-1.6-py3-none-any.whl

Download URL	udsoncan-1.6-py3-none-any.whl
Size	113.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a0c4d9833136129535a0dfb5aa17d62aacbb0ea9c44048fed6f78eb6f6fbafa5`
BLAKE2b-256 checksum How to use checksums	`56c378b6a89490c73476b9a10c97d8750058f82dd4b5acf3c96e3a1ef3a8306a`
Upload date	Nov 28, 2018
Uploaded using Trusted Publishing? What is 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`