#automotive #uds #obd #kwp2000

no-std automotive_diag

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

10 releases

0.1.9 Jul 24, 2024
0.1.8 Jul 1, 2024
0.1.7 Jun 20, 2024
0.1.6 Nov 8, 2023
0.1.3 Apr 15, 2023

#75 in Embedded development

Download history 654/week @ 2024-07-29 882/week @ 2024-08-05 836/week @ 2024-08-12 1035/week @ 2024-08-19 1000/week @ 2024-08-26 392/week @ 2024-09-02 625/week @ 2024-09-09 523/week @ 2024-09-16 851/week @ 2024-09-23 627/week @ 2024-09-30 1193/week @ 2024-10-07 1071/week @ 2024-10-14 1162/week @ 2024-10-21 667/week @ 2024-10-28 1087/week @ 2024-11-04 1139/week @ 2024-11-11

4,067 downloads per month
Used in ecu_diagnostics

MIT/Apache

72KB
1K SLoC

Automotive diagnostics in Rust

GitHub crates.io version docs.rs docs crates.io version CI build

This crate provides low-level no_std structs and enums of the Unified Diagnostic Services (ISO-14229-1), KWP2000 (ISO-142330) and OBD-II (ISO-9141) specifications for the road vehicles in Rust.

Not everything is implemented yet, but the goal is to provide a full set of enums and structs to handle the most common diagnostic commands and responses. If you need a specific command or response, please open an issue or better yet, a pull request.

Usage

All values are presented as Rust enum, and can be converted to/from their underlying numeric values using the T::from_repr(u8) and u8::from(value). Most enums also have a corresponding ...Byte enums as ByteWrapper<T> to handle the non-standard Extended(u8) values in addition to the defined 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
        }
    }
}

Development

  • This project is easier to develop with just, a modern alternative to make. Install it with cargo install just.
  • To get a list of available commands, run just.
  • To run tests, use just test.
  • On git push, it will run a few validations, including cargo fmt, cargo clippy, and cargo test. Use git push --no-verify to skip these checks.

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.

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.3–0.8MB
~19K SLoC