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

// Copyright lowRISC contributors (OpenTitan project).
// Licensed under the Apache License, Version 2.0, see LICENSE for details.
// SPDX-License-Identifier: Apache-2.0

use serde::{Deserialize, Serialize};
use thiserror::Error;

use super::Capability;
use crate::impl_serializable_error;

/// Contains all the errors that any method on the `Transport` trait could generate.  This
/// struct is serializable, such that it can be transmitted across a network for instance as
/// part of the session proxy functionality.
#[derive(Error, Debug, Serialize, Deserialize)]
pub enum TransportError {
    #[error("USB device did not match")]
    NoMatch,
    #[error("Found no USB device")]
    NoDevice,
    #[error("Found multiple USB devices, use --usb-serial")]
    MultipleDevices,
    #[error("USB error: {0}")]
    UsbGenericError(String),
    #[error("Error opening USB device: {0}")]
    UsbOpenError(String),
    #[error("Transport does not support {0:?}")]
    InvalidInterface(TransportInterfaceType),
    #[error("Transport does not support {0:?} instance {1}")]
    InvalidInstance(TransportInterfaceType, String),
    #[error("Encountered non-unicode device path")]
    UnicodePathError,
    #[error("Error opening {0}: {1}")]
    OpenError(String, String),
    #[error("Error reading from {0}: {1}")]
    ReadError(String, String),
    #[error("FPGA programming failed: {0}")]
    FpgaProgramFailed(String),
    #[error("Firmware programming failed: {0}")]
    FirmwareProgramFailed(String),
    #[error("Error clearing FPGA bitstream")]
    ClearBitstreamFailed(),
    #[error("PLL programming failed: {0}")]
    PllProgramFailed(String),
    #[error("Invalid pin strapping name \"{0}\"")]
    InvalidStrappingName(String),
    #[error("Invalid IO expander name \"{0}\"")]
    InvalidIoExpanderName(String),
    #[error("Invalid pin {1} for IO expander \"{0}\"")]
    InvalidIoExpanderPinNo(String, u32),
    #[error("Transport does not support the requested operation")]
    UnsupportedOperation,
    #[error("Requested operation invalid at this time")]
    InvalidOperation,
    #[error("Error communicating with FTDI: {0}")]
    FtdiError(String),
    #[error("Error communicating with debugger: {0}")]
    CommunicationError(String),
    #[error("Proxy unable to resolve `{0}`: {1}")]
    ProxyLookupError(String, String),
    #[error("Proxy unable to connect to `{0}`: {1}")]
    ProxyConnectError(String, String),
    #[error("Requested capabilities {0:?}, but capabilities {1:?} are supplied")]
    MissingCapabilities(Capability, Capability),
    #[error("Inconsistent configuration for {0:?} instance \"{1}\"")]
    InconsistentConf(TransportInterfaceType, String),
    #[error("Inconsistent configuration of transport interface \"{0}\" vs. \"{1}\"")]
    InconsistentInterfaceConf(String, String),
    #[error("Strapping \"{0}\" pin \"{1}\" cannot declare \"alias_of\"")]
    InvalidConfStrapAlias(String, String),
    #[error("Strapping \"{0}\" pin \"{1}\" cannot declare \"invert\"")]
    InvalidConfStrapInvert(String, String),
    #[error("Expected value \"{1}\" for key \"{0}\", found \"{2}\"")]
    RequiresUnequal(String, String, String),
    #[error("Expected value \"{1}\" for key \"{0}\", found none")]
    RequiresMissing(String, String),
}
impl_serializable_error!(TransportError);

/// Enum value used by `TransportError::InvalidInstance`.
#[derive(Debug, serde::Serialize, serde::Deserialize)]
pub enum TransportInterfaceType {
    Gpio,
    Uart,
    Spi,
    I2c,
    Jtag,
    Emulator,
    ProxyOps,
    GpioMonitoring,
    GpioBitbanging,
    IoExpander,
    Provides,
}