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
Release history Release notifications | RSS feed
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)
Built Distribution
udsoncan-1.8-py3-none-any.whl
(107.3 kB
view details)
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
beb34bf11c229131c2e87fd0e0263b91787913e79d8462408e8cb04666351e8b
|
|
MD5 |
595e5703076859af6f05faa074c18d86
|
|
BLAKE2b-256 |
c2215a72a2ad392a802c11f53884b5825b0c5c17ea469c44b2b550dcf88c0808
|
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
c71195d3a8fa10f0b17fb13d705c0dd2a37c1100855d95e6c3fede3e8fef3c3b
|
|
MD5 |
e4352041d5e9cbccc382eb85b8fe5baf
|
|
BLAKE2b-256 |
b51a0ea57ac011d4d9cbd020551097f401d8cd5d8348e46a6a347ced07d50860
|