drone 0.14.0

CLI utility for Drone, an Embedded Operating System. 
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

//! Supported devices.

mod registry;

pub use self::registry::REGISTRY;

use crate::crates;
use anyhow::{bail, Result};

/// Device configuration.
pub struct Device {
    /// Device name.
    pub name: &'static str,
    /// Target triple.
    pub target: &'static str,
    /// Flash memory origin address.
    pub flash_origin: u32,
    /// RAM memory origin address.
    pub ram_origin: u32,
    /// Drone platform crate configuration.
    pub platform_crate: PlatformCrate,
    /// Drone bindings crate configuration.
    pub bindings_crate: BindingsCrate,
    /// Black Magic Probe configuration.
    pub probe_bmp: Option<ProbeBmp>,
    /// OpenOCD configuration.
    pub probe_openocd: Option<ProbeOpenocd>,
    /// Segger J-Link configuration.
    pub probe_jlink: Option<ProbeJlink>,
    /// ARM® SWO configuration.
    pub log_swo: Option<LogSwo>,
    /// Drone Serial Output configuration.
    pub log_dso: Option<LogDso>,
}

/// Drone platform crate configuration.
pub struct PlatformCrate {
    /// Drone platform crate.
    pub krate: crates::Platform,
    /// Configuration flag value.
    pub flag: &'static str,
    /// Available features.
    pub features: &'static [&'static str],
}

/// Drone bindings crate configuration.
pub struct BindingsCrate {
    /// Drone bindings crate.
    pub krate: crates::Bindings,
    /// Configuration flag value.
    pub flag: &'static str,
    /// Available features.
    pub features: &'static [&'static str],
}

/// Black Magic Probe configuration.
pub struct ProbeBmp {
    /// Device identifier.
    pub device: &'static str,
}

/// OpenOCD configuration.
pub struct ProbeOpenocd {
    /// Command-line arguments to OpenOCD.
    pub arguments: &'static [&'static str],
}

/// Segger J-Link configuration.
pub struct ProbeJlink {
    /// Device identifier.
    pub device: &'static str,
    /// Target interface.
    pub interface: &'static str,
}

/// ARM® SWO configuration.
pub struct LogSwo {
    /// SWO frequency at reset.
    pub reset_freq: u32,
}

/// Drone Serial Output configuration.
pub struct LogDso {
    /// Drone bindings crate.
    pub krate: crates::Dso,
    /// Available features.
    pub features: &'static [&'static str],
}

/// Finds device configuration by `name`.
pub fn find(name: &str) -> Result<&'static Device> {
    for device in REGISTRY {
        if device.name == name {
            return Ok(device);
        }
    }
    bail!("Couldn't find device with name `{}`", name);
}

impl PlatformCrate {
    /// Returns linker platform option value.
    pub fn linker_platform(&self) -> &'static str {
        match self.krate {
            crates::Platform::Cortexm => "arm",
            crates::Platform::Riscv => "riscv",
        }
    }
}