Rust in NuttX
Warning
This guide is under development. Rust support in NuttX is experimental.
Introduction
NuttX is exploring Rust integration to provide memory safety guarantees and modern language features while maintaining its small footprint and real-time capabilities.
This guide covers:
Setting up Rust toolchain for NuttX development
Building Rust components with NuttX
Interoperability between Rust and C
Testing Rust components
Prerequisites
Rust toolchain installed (rustup recommended)
NuttX build environment configured
Basic knowledge of Rust and NuttX development
Supported Platforms
AArch64
ARMv7-A
ARMv6-M
ARMv7-M
ARMv8-M
RISCV32
RISCV64
X86
X86_64
Getting Started
Install Rust toolchain and switch to nightly
Please refer to the official Rust installation guide for more details: https://www.rust-lang.org/tools/install
rustup toolchain install nightly
rustup default nightly
Prepare NuttX build environment
Please ensure that you have a working NuttX build environment, and with the following PR merged or cherry-picked:
Enable essential kernel configurations
Please enable the following configurations in your NuttX configuration:
CONFIG_SYSTEM_TIME64
CONFIG_FS_LARGEFILE
CONFIG_TLS_NELEM = 16
CONFIG_DEV_URANDOM
The rv-virt:nsh board using make as the build system is recommended for testing Rust applications as it has been verified to work with this configuration.
For rv-virt:nsh board, you should disable CONFIG_ARCH_FPU configuration since RISCV32 with FPU is not supported yet.
Enable sample application
Please enable the sample application in your NuttX configuration: - CONFIG_EXAMPLES_HELLO_RUST_CARGO
Build and run the sample application
Build the NuttX image and run it on your target platform:
qemu-system-riscv32 -semihosting -M virt,aclint=on -cpu rv32 -smp 8 -bios nuttx/nuttx -nographic
NuttShell (NSH) NuttX-12.8.0
nsh> hello_rust_cargo
{"name":"John","age":30}
{"name":"Jane","age":25}
Deserialized: Alice is 28 years old
Pretty JSON:
{
"name": "Alice",
"age": 28
}
Hello world from tokio!
Congratulations! You have successfully built and run a Rust application on NuttX.
Specifying Target CPU for Optimization
To optimize your Rust application for a specific CPU, you can use the RUSTFLAGS environment variable to specify the target CPU. This can significantly improve performance by enabling CPU-specific optimizations.
The RUSTFLAGS environment variable is particularly useful when you are working with CPUs that share the same Instruction Set Architecture (ISA) but have different microarchitectures. For example, both the Cortex-M33 and Cortex-M55 share the thumbv8m.main target name, but they have different performance characteristics and features. By specifying the actual CPU core, you can take advantage of the specific optimizations and features of the target CPU, leading to better performance and efficiency.
For instance, if you are targeting a Cortex-M33, you would set the RUSTFLAGS environment variable as follows:
export RUSTFLAGS="-C target-cpu=cortex-m33"
And for a Cortex-M55, you would use:
export RUSTFLAGS="-C target-cpu=cortex-m55"
This ensures that the Rust compiler generates optimized code tailored to the specific CPU core, rather than a generic ISA.
Set the RUSTFLAGS environment variable to include the –target-cpu flag:
export RUSTFLAGS="-C target-cpu=your_cpu_model"
Replace your_cpu_model with the specific CPU model you are targeting. For example, for an ARM Cortex-M4, you would use:
export RUSTFLAGS="-C target-cpu=cortex-m4"
Build your NuttX image with the specified target CPU:
make
This will ensure that the Rust compiler generates optimized code for the specified CPU.
Editor Integration
To enable proper IDE support for Rust development in NuttX, you’ll need to configure your editor to recognize the Rust project structure correctly. This section focuses on VS Code with rust-analyzer, which is the most popular setup.
Create or update .vscode/settings.json in your NuttX workspace:
{
"rust-analyzer.linkedProjects": [
"nuttx-apps/examples/rust/slint/Cargo.toml"
]
}
(Optional) If you’re using a custom target specification, you can set the rust-analyzer.cargo.target setting:
{
"rust-analyzer.cargo.target": "thumbv8m.main-nuttx-eabihf"
}
Note
Since NuttX now supports the Rust standard library (std), specifying an exact target triple is usually not necessary. The default host target should work fine for most cases.
If you’re working with a crate that tightly depends on the NuttX target, you can specify the target triple as shown above to get more accurate code analysis.
This configuration helps rust-analyzer understand your project structure and provide accurate code analysis, auto-completion, and other IDE features while working with Rust code in NuttX.