iso14229-1 0.1.0

A ISO 14229-1 protocol.
Documentation 
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

#![allow(clippy::non_minimal_cfg)]

mod common;
mod config;
mod constant;
mod error;
pub mod request;
pub mod response;
pub mod utils;

pub use self::{common::*, config::*, constant::*, error::Error as Iso14229Error};

use std::fmt::{Display, Formatter};

rsutil::enum_extend!(
    /// the service marked with `✅` is completed.
    ///
    /// the service marked with `⭕` is partially completed.
    ///
    /// The service marked with `❌` is not implemented.
    #[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)]
    pub enum Service {
        SessionCtrl = 0x10,         // ✅
        ECUReset = 0x11,            // ✅
        ClearDiagnosticInfo = 0x14, // ✅
        ReadDTCInfo = 0x19,         // ✅
        ReadDID = 0x22,             // ✅
        ReadMemByAddr = 0x23,       // ✅
        ReadScalingDID = 0x24,      // ✅
        SecurityAccess = 0x27,      // ✅
        CommunicationCtrl = 0x28,   // ✅
        #[cfg(any(feature = "std2020"))]
        Authentication = 0x29,      // ✅
        ReadDataByPeriodId = 0x2A,  // ✅
        DynamicalDefineDID = 0x2C,  // ✅
        WriteDID = 0x2E,            // ✅
        IOCtrl = 0x2F,              // ✅
        RoutineCtrl = 0x31,         // ✅
        RequestDownload = 0x34,     // ✅
        RequestUpload = 0x35,       // ✅
        TransferData = 0x36,        // ✅
        RequestTransferExit = 0x37, // ✅
        #[cfg(any(feature = "std2013", feature = "std2020"))]
        RequestFileTransfer = 0x38, // ✅
        WriteMemByAddr = 0x3D,      // ✅
        TesterPresent = 0x3E,       // ✅
        #[cfg(any(feature = "std2006", feature = "std2013"))]
        AccessTimingParam = 0x83,   // ✅
        SecuredDataTrans = 0x84,    // ✅
        CtrlDTCSetting = 0x85,      // ✅
        ResponseOnEvent = 0x86,     // ✅
        LinkCtrl = 0x87,            // ✅
        NRC = 0x7F,
    },
    u8,
    error::Error,
    ReservedError
);

impl Display for Service {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::SessionCtrl => write!(f, "DiagnosticSessionControl"),
            Self::ECUReset => write!(f, "ECUReset"),
            Self::ClearDiagnosticInfo => write!(f, "ClearDiagnosticInformation"),
            Self::ReadDTCInfo => write!(f, "ReadDTCInformation"),
            Self::ReadDID => write!(f, "ReadDataByIdentifier"),
            Self::ReadMemByAddr => write!(f, "ReadMemoryByAddress"),
            Self::ReadScalingDID => write!(f, "ReadScalingDataByIdentifier"),
            Self::SecurityAccess => write!(f, "SecurityAccess"),
            Self::CommunicationCtrl => write!(f, "CommunicationControl"),
            #[cfg(any(feature = "std2020"))]
            Self::Authentication => write!(f, "Authentication"),
            Self::ReadDataByPeriodId => write!(f, "ReadDataByPeriodicIdentifier"),
            Self::DynamicalDefineDID => write!(f, "DynamicalDefineDyIdentifier"),
            Self::WriteDID => write!(f, "WriteDataByIdentifier"),
            Self::IOCtrl => write!(f, "IOControl"),
            Self::RoutineCtrl => write!(f, "RoutineControl"),
            Self::RequestDownload => write!(f, "RequestDownload"),
            Self::RequestUpload => write!(f, "RequestUpload"),
            Self::TransferData => write!(f, "TransferData"),
            Self::RequestTransferExit => write!(f, "RequestTransferExit"),
            #[cfg(any(feature = "std2013", feature = "std2020"))]
            Self::RequestFileTransfer => write!(f, "RequestFileTransfer"),
            Self::WriteMemByAddr => write!(f, "WriteMemoryByAddress"),
            Self::TesterPresent => write!(f, "TesterPresent"),
            #[cfg(any(feature = "std2006", feature = "std2013"))]
            Self::AccessTimingParam => write!(f, "AccessTimingParam"),
            Self::SecuredDataTrans => write!(f, "SecuredDataTransmission"),
            Self::CtrlDTCSetting => write!(f, "ControlDTCSetting"),
            Self::ResponseOnEvent => write!(f, "ResponseOnEvent"),
            Self::LinkCtrl => write!(f, "LinkControl"),
            Self::NRC => write!(f, "Negative Response with Code"),
        }
    }
}

pub trait RequestData:
    Into<Vec<u8>> + for<'a> TryFrom<(&'a request::Request, &'a Configuration), Error = error::Error>
{
    fn new_request<T: AsRef<[u8]>>(
        data: T,
        sub_func: Option<u8>,
        cfg: &Configuration,
    ) -> Result<request::Request, error::Error>;
}

// TryFrom<(T, &Configuration)>
pub trait ResponseData:
    Into<Vec<u8>> + for<'a> TryFrom<(&'a response::Response, &'a Configuration), Error = error::Error>
{
    fn new_response<T: AsRef<[u8]>>(
        data: T,
        sub_func: Option<u8>,
        cfg: &Configuration,
    ) -> Result<response::Response, error::Error>;
}