0a34928ad8
Add `std` support for `armv7a-vex-v5`
This PR adds standard library support for the VEX V5 Brain (`armv7a-vex-v5` target). It is more-or-less an updated version of the library-side work done in rust-lang/rust#131530.
This was a joint effort between me, `@lewisfm,` `@max-niederman,` `@Gavin-Niederman` and several other members of the [`vexide` project](https://github.com/vexide/).
## Background
VEXos is a fairly unconventional operating system, with user code running in a restricted enviornment with regards to I/O capabilities and whatnot. As such, several OS-dependent APIs are unsupported or have partial support (such as `std::net`, `std::process`, and most of `std::thread`). A more comprehensive list of what does or doesn't work is outlined in the [updated target documentation](https://github.com/vexide/rust/blob/vex-std/src/doc/rustc/src/platform-support/armv7a-vex-v5.md). Despite these limitations, we believe that `libstd` support on this target still has value to users, especially given the popular use of this hardware for educational purposes. For some previous discussion on this matter, see [this comment](https://github.com/rust-lang/rust/pull/131530#issuecomment-2432856841).
## SDK Linkage
VEXos doesn't really ship with an official `libc` or POSIX-style platform API (and though it does port newlib, these are stubbed on top of the underlying SDK). Instead, VEX provides their own SDK for calling platform APIs. Their official SDK is kept proprietary (with public headers), though open-source implementations exist. Following the precedent of the `armv6k-nintendo-3ds` team's work in rust-lang/rust#95897, we've opted not to directly link `libstd` to any SDK with the expectation that users will provide their own with one of the following options:
- [`vex-sdk-download`](https://github.com/vexide/vex-sdk/tree/main/packages/vex-sdk-download), which downloads an official proprietary SDK from VEX using a build script.
- [`vex-sdk-jumptable`](https://crates.io/crates/vex-sdk-jumptable), which is a compatible, open-source reimplementation of the SDK using firmware jumps.
- [`vex-sdk-pros`](https://github.com/vexide/vex-sdk/tree/main/packages/vex-sdk-pros), which uses the [PROS kernel](https://github.com/purduesigbots/pros) as a provider for SDK functions.
- Linking their own implementation or stubbing the functions required by libstd.
The `vex-sdk` crate used in the VEXos PAL provides `libc`-style FFI bindings for any compatible system library, so any of these options *should* work fine. A functional demo project using `vex-sdk-download` can be found [here](https://github.com/vexide/armv7a-vex-v5-demo/tree/main).
## Future Work
This PR implements virtually everything we are currently able to implement given the current capabilities of the platform. The exception to this is file directory enumeration, though the implementation of that is sufficiently [gross enough](c6c5bad11e/packages/vexide-core/src/fs/mod.rs (L987)) to drive us away from supporting this officially.
Additionally, I have a working branch implementing the `panic_unwind` runtime for this target, which is something that would be nice to see in the future, though given the volume of compiler changes i've deemed it out-of-scope for this PR.
171 lines
5.4 KiB
TOML
171 lines
5.4 KiB
TOML
cargo-features = ["public-dependency"]
|
|
|
|
[package]
|
|
name = "std"
|
|
version = "0.0.0"
|
|
license = "MIT OR Apache-2.0"
|
|
repository = "https://github.com/rust-lang/rust.git"
|
|
description = "The Rust Standard Library"
|
|
edition = "2024"
|
|
autobenches = false
|
|
|
|
[lib]
|
|
crate-type = ["dylib", "rlib"]
|
|
|
|
[dependencies]
|
|
alloc = { path = "../alloc", public = true }
|
|
# std no longer uses cfg-if directly, but the included copy of backtrace does.
|
|
cfg-if = { version = "1.0", features = ['rustc-dep-of-std'] }
|
|
panic_unwind = { path = "../panic_unwind", optional = true }
|
|
panic_abort = { path = "../panic_abort" }
|
|
core = { path = "../core", public = true }
|
|
unwind = { path = "../unwind" }
|
|
hashbrown = { version = "0.15", default-features = false, features = [
|
|
'rustc-dep-of-std',
|
|
] }
|
|
std_detect = { path = "../std_detect", public = true }
|
|
|
|
# Dependencies of the `backtrace` crate
|
|
rustc-demangle = { version = "0.1.24", features = ['rustc-dep-of-std'] }
|
|
|
|
[target.'cfg(not(all(windows, target_env = "msvc", not(target_vendor = "uwp"))))'.dependencies]
|
|
miniz_oxide = { version = "0.8.0", optional = true, default-features = false }
|
|
addr2line = { version = "0.25.0", optional = true, default-features = false }
|
|
|
|
[target.'cfg(not(all(windows, target_env = "msvc")))'.dependencies]
|
|
libc = { version = "0.2.172", default-features = false, features = [
|
|
'rustc-dep-of-std',
|
|
], public = true }
|
|
|
|
[target.'cfg(all(not(target_os = "aix"), not(all(windows, target_env = "msvc", not(target_vendor = "uwp")))))'.dependencies]
|
|
object = { version = "0.37.1", default-features = false, optional = true, features = [
|
|
'read_core',
|
|
'elf',
|
|
'macho',
|
|
'pe',
|
|
'unaligned',
|
|
'archive',
|
|
] }
|
|
|
|
[target.'cfg(target_os = "aix")'.dependencies]
|
|
object = { version = "0.37.1", default-features = false, optional = true, features = [
|
|
'read_core',
|
|
'xcoff',
|
|
'unaligned',
|
|
'archive',
|
|
] }
|
|
|
|
[target.'cfg(any(windows, target_os = "cygwin"))'.dependencies.windows-targets]
|
|
path = "../windows_targets"
|
|
|
|
[dev-dependencies]
|
|
rand = { version = "0.9.0", default-features = false, features = ["alloc"] }
|
|
rand_xorshift = "0.4.0"
|
|
|
|
[target.'cfg(any(all(target_family = "wasm", target_os = "unknown"), target_os = "xous", target_os = "vexos", all(target_vendor = "fortanix", target_env = "sgx")))'.dependencies]
|
|
dlmalloc = { version = "0.2.10", features = ['rustc-dep-of-std'] }
|
|
|
|
[target.x86_64-fortanix-unknown-sgx.dependencies]
|
|
fortanix-sgx-abi = { version = "0.6.1", features = [
|
|
'rustc-dep-of-std',
|
|
], public = true }
|
|
|
|
[target.'cfg(target_os = "hermit")'.dependencies]
|
|
hermit-abi = { version = "0.5.0", features = [
|
|
'rustc-dep-of-std',
|
|
], public = true }
|
|
|
|
[target.'cfg(target_os = "wasi")'.dependencies]
|
|
wasi = { version = "0.11.0", features = [
|
|
'rustc-dep-of-std',
|
|
], default-features = false }
|
|
|
|
[target.'cfg(all(target_os = "wasi", target_env = "p2"))'.dependencies]
|
|
wasip2 = { version = '0.14.4', features = [
|
|
'rustc-dep-of-std',
|
|
], default-features = false, package = 'wasi' }
|
|
|
|
[target.'cfg(target_os = "uefi")'.dependencies]
|
|
r-efi = { version = "5.2.0", features = ['rustc-dep-of-std'] }
|
|
r-efi-alloc = { version = "2.0.0", features = ['rustc-dep-of-std'] }
|
|
|
|
[target.'cfg(target_os = "vexos")'.dependencies]
|
|
vex-sdk = { version = "0.27.0", features = [
|
|
'rustc-dep-of-std',
|
|
], default-features = false }
|
|
|
|
[features]
|
|
backtrace = [
|
|
'addr2line/rustc-dep-of-std',
|
|
'object/rustc-dep-of-std',
|
|
'miniz_oxide/rustc-dep-of-std',
|
|
]
|
|
# Disable symbolization in backtraces. For use with -Zbuild-std.
|
|
# FIXME: Ideally this should be an additive backtrace-symbolization feature
|
|
backtrace-trace-only = []
|
|
|
|
panic-unwind = ["dep:panic_unwind"]
|
|
compiler-builtins-c = ["alloc/compiler-builtins-c"]
|
|
compiler-builtins-mem = ["alloc/compiler-builtins-mem"]
|
|
compiler-builtins-no-f16-f128 = ["alloc/compiler-builtins-no-f16-f128"]
|
|
llvm-libunwind = ["unwind/llvm-libunwind"]
|
|
system-llvm-libunwind = ["unwind/system-llvm-libunwind"]
|
|
|
|
# Choose algorithms that are optimized for binary size instead of runtime performance
|
|
optimize_for_size = ["core/optimize_for_size", "alloc/optimize_for_size"]
|
|
|
|
# Make `RefCell` store additional debugging information, which is printed out when
|
|
# a borrow error occurs
|
|
debug_refcell = ["core/debug_refcell"]
|
|
|
|
|
|
# Enable std_detect features:
|
|
std_detect_file_io = ["std_detect/std_detect_file_io"]
|
|
std_detect_dlsym_getauxval = ["std_detect/std_detect_dlsym_getauxval"]
|
|
|
|
# Enable using raw-dylib for Windows imports.
|
|
# This will eventually be the default.
|
|
windows_raw_dylib = ["windows-targets/windows_raw_dylib"]
|
|
|
|
[package.metadata.fortanix-sgx]
|
|
# Maximum possible number of threads when testing
|
|
threads = 125
|
|
# Maximum heap size
|
|
heap_size = 0x8000000
|
|
|
|
[[test]]
|
|
name = "pipe-subprocess"
|
|
path = "tests/pipe_subprocess.rs"
|
|
harness = false
|
|
|
|
[[test]]
|
|
name = "sync"
|
|
path = "tests/sync/lib.rs"
|
|
|
|
[[test]]
|
|
name = "floats"
|
|
path = "tests/floats/lib.rs"
|
|
|
|
[[test]]
|
|
name = "thread_local"
|
|
path = "tests/thread_local/lib.rs"
|
|
|
|
[[bench]]
|
|
name = "stdbenches"
|
|
path = "benches/lib.rs"
|
|
test = true
|
|
|
|
[lints.rust.unexpected_cfgs]
|
|
level = "warn"
|
|
check-cfg = [
|
|
# std use #[path] imports to portable-simd `std_float` crate
|
|
# and to the `backtrace` crate which messes-up with Cargo list
|
|
# of declared features, we therefor expect any feature cfg
|
|
'cfg(feature, values(any()))',
|
|
# Internal features aren't marked known config by default, we use these to
|
|
# gate tests.
|
|
'cfg(target_has_reliable_f16)',
|
|
'cfg(target_has_reliable_f16_math)',
|
|
'cfg(target_has_reliable_f128)',
|
|
'cfg(target_has_reliable_f128_math)',
|
|
]
|