automotive_diag 0.1.3

Core definitions for various Automotive ECU Diagnostics such as UDS ISO-14229, KWP2000, OBD-II, etc.
Documentation

automotive_diag

GitHub crates.io version docs.rs docs CI build

This crate provides low-level no_std structs and enums of the Unified Diagnostic Services specification for the road vehicles iso-14229-1 in Rust.

Usage

All values are presented as Rust enum, and can be converted to/from their underlying numeric values using the From<T> and TryFrom<u8> traits. Additionally, there is a ByteWrapper<T> enum to handle the non-standard Extended(u8) values in addition to the recognized Standand(T) ones.

use automotive_diag::ByteWrapper::{Extended, Standard};
use automotive_diag::uds::UdsCommand::{DiagnosticSessionControl, ECUReset};
use automotive_diag::uds::UdsCommandByte;

/// Handle a single command byte on the ECU side
fn handle_cmd_byte(cmd: u8) {
    match UdsCommandByte::from(cmd) {
        Standard(DiagnosticSessionControl) => {
            // handle_diag_session()
        },
        Standard(ECUReset) => {
            // handle_ecu_reset()
        },
        Extended(0x42) => {
            // handle_custom_cmd_42()
        },
        _ => {
            // handle all other commands
        }
    }
}

Additionally, support KWP2000 and OBD-II protocols.

Credits

The code was forked from the amazing rnd-ash/ecu_diagnostics project. The code was forked from the last MIT-versioned code before the MIT to GPL license migration. Initially, this code was developed as a deprecated auto_uds crate.