vil_edge_deploy 0.4.0

VIL Edge Deployment — ARM/RISC-V build profiles and minimal runtime config
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

// =============================================================================
// vil_edge_deploy::targets — Supported cross-compile targets
// =============================================================================

use serde::{Deserialize, Serialize};

/// Supported cross-compilation targets.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default)]
#[serde(rename_all = "snake_case")]
pub enum EdgeTarget {
    /// aarch64-unknown-linux-gnu (ARM64, Raspberry Pi 4, Jetson, etc.)
    Aarch64Linux,
    /// armv7-unknown-linux-gnueabihf (ARMv7 hard-float, Raspberry Pi 2/3)
    Armv7Linux,
    /// riscv64gc-unknown-linux-gnu (RISC-V 64-bit, VisionFive 2, etc.)
    Riscv64Linux,
    /// x86_64-unknown-linux-gnu (default, server-class edge hardware)
    #[default]
    X86_64Linux,
}

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

impl EdgeTarget {
    /// The canonical Rust target triple for this target.
    pub fn rustc_target_triple(self) -> &'static str {
        match self {
            EdgeTarget::Aarch64Linux => "aarch64-unknown-linux-gnu",
            EdgeTarget::Armv7Linux => "armv7-unknown-linux-gnueabihf",
            EdgeTarget::Riscv64Linux => "riscv64gc-unknown-linux-gnu",
            EdgeTarget::X86_64Linux => "x86_64-unknown-linux-gnu",
        }
    }

    /// Returns cargo CLI arguments for cross-compiling to this target.
    ///
    /// Example output for `Aarch64Linux`:
    /// ```text
    /// ["--target", "aarch64-unknown-linux-gnu"]
    /// ```
    pub fn cargo_build_args(self) -> Vec<&'static str> {
        match self {
            EdgeTarget::X86_64Linux => vec![], // native — no --target needed
            _ => vec!["--target", self.rustc_target_triple()],
        }
    }

    /// Linker prefix used by the GNU cross-toolchain for this target.
    pub fn linker_prefix(self) -> Option<&'static str> {
        match self {
            EdgeTarget::Aarch64Linux => Some("aarch64-linux-gnu-gcc"),
            EdgeTarget::Armv7Linux => Some("arm-linux-gnueabihf-gcc"),
            EdgeTarget::Riscv64Linux => Some("riscv64-linux-gnu-gcc"),
            EdgeTarget::X86_64Linux => None,
        }
    }

    /// Whether this target requires a cross-compiler toolchain.
    pub fn is_cross(self) -> bool {
        !matches!(self, EdgeTarget::X86_64Linux)
    }

    /// Returns all supported targets.
    pub fn all() -> &'static [EdgeTarget] {
        &[
            EdgeTarget::X86_64Linux,
            EdgeTarget::Aarch64Linux,
            EdgeTarget::Armv7Linux,
            EdgeTarget::Riscv64Linux,
        ]
    }
}