stm32cubeprogrammer 0.1.0

Rust bindings for the STM32CubeProgrammer API
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

use derive_more::{Display, Error};

pub type CubeProgrammerResult<T> = std::result::Result<T, CubeProgrammerError>;

/// Add additional context why a type conversion failed
#[derive(Debug, Error, Display)]
pub enum TypeConversionError {
    Utf8Error,
    Utf16Error,
    NullError,
    BytemuckError,
    VersionError,
}

#[derive(Debug, Error, Display)]
pub enum Action {
    Connect,
    ReadTargetInfo,
    ReadMemory,
    WriteMemory,
    StartFus,
    ReadFusInfo,
    Reset,
    DownloadFile,
    MassErase,
    SaveMemory,
    EnableReadOutProtection,
    DisableReadOutProtection,
    CheckConnection,
    UpgradeWirelessStack,
    DeleteWirelessStack,
    StartWirelessStack,
    ListConnectedProbes,
    WriteCoreRegister,
    ReadCoreRegister,
}

#[derive(Debug, Error, Display)]
pub enum UnexpectedOutput {
    Null,
    SliceConversion,
    SliceLength,
}

#[derive(Debug, Error, Display)]
pub enum CubeProgrammerError {
    #[display("Action {} failed with return code: {}", action, return_code)]
    ActionFailed {
        action: Action,
        return_code: crate::api_types::ErrorCode,
    },

    #[display("Action {} returns unexpected output: {}", action, unexpected_output)]
    ActionOutputUnexpected {
        action: Action,
        unexpected_output: UnexpectedOutput,
    },

    #[display("Action {} not supported: {}", action, message)]
    ActionNotSupported {
        action: Action,
        message: String,
    },

    #[display("Parameter error: {}", message)]
    Parameter {
        action: Action,
        message: String,
    },

    #[display("Conversion error: {}", message)]
    TypeConversion {
        message: String,

        #[error(source)]
        source: TypeConversionError,
    },

    FileIo(std::io::Error),

    LibLoading(stm32cubeprogrammer_sys::libloading::Error),

    MissingDllSymbol {
        message: String,
    },
}