ecu_diagnostics 0.105.0

A rust crate for ECU diagnostic servers and communication APIs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! This service allows for the clearing of DTCs
//! (Diagnostic trouble codes) from the ECU

use crate::{dynamic_diag::DynamicDiagSession, DiagServerResult};
use automotive_diag::kwp2000::KwpCommand;

#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
/// Denotes a single or range of DTCs that can be cleared from the ECU
///
/// Command support matrix
///
/// | DTCRange | Support by ECUs |
/// |--|--|
/// |[ClearDTCRange::AllPowertrain]|Optional|
/// |[ClearDTCRange::AllChassis]|Optional|
/// |[ClearDTCRange::AllBody]|Optional|
/// |[ClearDTCRange::AllNetwork]|Optional|
/// |[ClearDTCRange::AllDTCs]|Mandatory|
/// |[ClearDTCRange::SingleDTC]|Optional|
pub enum ClearDTCRange {
    /// All powertrain related DTCs
    AllPowertrain,
    /// All Chassis related DTCs
    AllChassis,
    /// All body related DTCs
    AllBody,
    /// All network related DTCs
    AllNetwork,
    /// All DTCs stored on the ECU
    AllDTCs,
    /// Denotes a single specific DTC to clear.
    ///
    /// Acceptable ranges:
    /// * 0x0001-0x3FFF - Custom powertrain DTC
    /// * 0x4001-0x7FFF - Custom chassis DTC
    /// * 0x8001-0xBFFF - Custom body DTC
    /// * 0xC001-0xFEFF - Custom network DTC
    SingleDTC(u16),
}

impl From<ClearDTCRange> for u16 {
    fn from(x: ClearDTCRange) -> Self {
        match x {
            ClearDTCRange::AllPowertrain => 0x0000,
            ClearDTCRange::AllChassis => 0x4000,
            ClearDTCRange::AllBody => 0x8000,
            ClearDTCRange::AllNetwork => 0xC000,
            ClearDTCRange::AllDTCs => 0xFF00,
            ClearDTCRange::SingleDTC(x) => x,
        }
    }
}

impl DynamicDiagSession {
    /// Executes a DTC clear command on the ECU, given a range of DTCs to clear
    pub fn kwp_clear_dtc_range(&self, dtc_range: ClearDTCRange) -> DiagServerResult<()> {
        let dtc_range_num: u16 = dtc_range.into();
        self.send_command_with_response(
            KwpCommand::ClearDiagnosticInformation,
            &[(dtc_range_num >> 8) as u8, dtc_range_num as u8],
        )?;
        Ok(())
    }
}