vil_edge_deploy 0.1.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

// =============================================================================
// vil_edge_deploy::profile — EdgeProfile presets
// =============================================================================

use serde::{Deserialize, Serialize};

use crate::config::SchedulerMode;

/// Deployment profile controlling resource limits and scheduler behaviour.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default)]
#[serde(rename_all = "snake_case")]
pub enum EdgeProfile {
    /// Minimal: 4 MB SHM, 16 processes, single-core scheduler.
    /// Suitable for microcontrollers and very constrained IoT devices.
    Minimal,
    /// Standard: 64 MB SHM, 64 processes, multi-core scheduler.
    /// Suitable for Raspberry Pi, industrial gateways.
    #[default]
    Standard,
    /// Full: production-equivalent limits.
    /// Suitable for server-class edge hardware.
    Full,
}

impl std::fmt::Display for EdgeProfile {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            EdgeProfile::Minimal  => write!(f, "Minimal"),
            EdgeProfile::Standard => write!(f, "Standard"),
            EdgeProfile::Full     => write!(f, "Full"),
        }
    }
}

/// Preset values bundled with each profile.
#[derive(Debug, Clone, Copy)]
pub struct ProfilePreset {
    pub shm_size_kb:       u32,
    pub max_processes:     u16,
    pub scheduler_mode:    SchedulerMode,
    pub offline_buffer_kb: u32,
}

impl EdgeProfile {
    /// Return the default resource preset for this profile.
    pub fn preset(self) -> ProfilePreset {
        match self {
            EdgeProfile::Minimal => ProfilePreset {
                shm_size_kb:       4_096,   // 4 MB
                max_processes:     16,
                scheduler_mode:    SchedulerMode::SingleCore,
                offline_buffer_kb: 512,
            },
            EdgeProfile::Standard => ProfilePreset {
                shm_size_kb:       65_536,  // 64 MB
                max_processes:     64,
                scheduler_mode:    SchedulerMode::MultiCore,
                offline_buffer_kb: 8_192,
            },
            EdgeProfile::Full => ProfilePreset {
                shm_size_kb:       262_144, // 256 MB
                max_processes:     256,
                scheduler_mode:    SchedulerMode::MultiCore,
                offline_buffer_kb: 32_768,
            },
        }
    }
}