vexide-startup 0.5.0

User program startup and runtime support for vexide.
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

//! Brings the appropriate SDK backend into scope to allow `vex-sdk` to resolve the symbols.

// vex-sdk-mock takes priority over other SDKs to satisfy the resolver.
#[cfg(all(not(target_os = "vexos"), feature = "vex-sdk-mock"))]
use vex_sdk_mock as _;

// Ensure only one SDK implementation is used. If more than one is used, this will cause a linker
// error anyways, but we want to fail as early as possible here with an actually comprehensible
// error message.
//
// The exception is vex-sdk-mock, which may take priority over another SDK backend.
#[allow(dead_code)]
const _: () = {
    if (cfg!(feature = "vex-sdk-jumptable") as usize)
        + (cfg!(feature = "vex-sdk-vexcode") as usize)
        + (cfg!(feature = "vex-sdk-pros") as usize)
        > 1
    {
        panic!("Only one `vex-sdk` backend may be used at a time.");
    }
};

// If an unsupported SDK is specified on a non-VEXos target and we aren't using vex-sdk-mock, throw
// a compiler error.
#[cfg(all(
    any(
        feature = "vex-sdk-jumptable",
        feature = "vex-sdk-vexcode",
        feature = "vex-sdk-pros"
    ),
    not(target_os = "vexos"),
    not(feature = "vex-sdk-mock")
))]
compile_error!(
    "The specified `vex-sdk` backend is unsupported on this target. Consider enabling the `vex-sdk-mock` feature for a stubbed SDK backend."
);

// vex-sdk-jumptable and vex-sdk-pros may only be used on vexos targets or if vex-sdk-mock isn't
// specified already.
#[cfg(all(target_os = "vexos", feature = "vex-sdk-jumptable"))]
use vex_sdk_jumptable as _;
#[cfg(all(target_os = "vexos", feature = "vex-sdk-pros"))]
use vex_sdk_pros as _;