crab-usb 0.8.0

A usb host for embedded systems, written in Rust.
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

use core::fmt::Display;

pub use usb_if::err::{TransferError, USBError};
use xhci::ring::trb::event::CompletionCode;

pub type Result<T = ()> = core::result::Result<T, USBError>;

pub trait ConvertXhciError {
    fn to_result(self) -> core::result::Result<(), TransferError>;
}

impl ConvertXhciError for CompletionCode {
    fn to_result(self) -> core::result::Result<(), TransferError> {
        match self {
            CompletionCode::Success => Ok(()),
            CompletionCode::ShortPacket => Ok(()),
            CompletionCode::StallError => Err(TransferError::Stall),
            CompletionCode::MissedServiceError => {
                // MissedServiceError 通常是暂时性的，可以重试
                Err(TransferError::Other(anyhow!(
                    "XHCI temporary error: {self:?}"
                )))
            }
            _ => Err(TransferError::Other(anyhow!("XHCI error: {self:?}"))),
        }
    }
}

#[derive(thiserror::Error, Debug)]
pub struct HostError(USBError);

impl Display for HostError {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        write!(f, "{}", self.0)
    }
}

impl From<dma_api::DmaError> for HostError {
    fn from(value: dma_api::DmaError) -> Self {
        match value {
            dma_api::DmaError::NoMemory => Self(USBError::NoMemory),
            dma_api::DmaError::DmaMaskNotMatch { .. } => Self(USBError::NoMemory),
            e => Self(USBError::Other(e.into())),
        }
    }
}

impl From<HostError> for USBError {
    fn from(value: HostError) -> Self {
        value.0
    }
}