build.rs

#![allow(unused_imports)]
use std::env;
use std::fs::File;
use std::io::Write;
use std::path::PathBuf;

fn main() {
    #[cfg(not(any(
        feature = "full_unwind",
        feature = "systick",
        feature = "svcall",
        feature = "hardfault_from_usagefault",
        feature = "hardfault_from_busfault",
        feature = "hardfault_in_systick"
    )))]
    compile_error!("Please enable one of the unwind features in `Cargo.toml` to build the project");

    #[cfg(any(feature = "RP2040", feature = "nRF52833_xxAA", feature = "esp32c3"))]
    {
        // SECTION: Get `chip_name` from the feature name.
        #[cfg(feature = "RP2040")]
        let _chip_name = "RP2040";
        #[cfg(feature = "nRF52833_xxAA")]
        let _chip_name = "nRF52833_xxAA";
        #[cfg(feature = "esp32c3")]
        let _chip_name = "esp32c3";

        // SECTION: Get the directory where build script livesfrom the environment.
        let workspace_dir = env::var("CARGO_MANIFEST_DIR").unwrap();

        // SECTION: The name of the link script used by the linker.
        #[cfg(any(feature = "RP2040", feature = "nRF52833_xxAA"))]
        println!("cargo:rustc-link-arg-bins=-Tlink.x");

        #[cfg(feature = "esp32c3")]
        {
            // esp32c3-hal uses a unique linker name to manage the various boot options.
            println!("cargo:rustc-link-arg-bins=-Tlinkall.x");
        }

        // SECTION: Instead of copying the linker scripts around, we can now tell rustc where to look for them.
        // This tells cargo where to find additional '.x' files -- usually the "INCLUDE <file>.x" in the above link script.
        let link_search_dir = PathBuf::from(workspace_dir)
            .join("linker_files")
            .join(_chip_name);
        // "\"build.rustflags=['-L${workspaceFolder}/linker_files/${fileBasenameNoExtension}/']\""
        println!("cargo:rustc-link-search={}", link_search_dir.display());

        // SECTION: By default, Cargo will re-run a build script whenever
        // any file in the project changes. By specifying `memory.x`
        // here, we ensure the build script is only re-run when
        // `memory.x` is changed.
        println!("cargo:rerun-if-changed=build.rs");
        println!("cargo:rerun-if-changed=Cargo.toml");
        println!("cargo:rerun-if-changed=linker_files/*/memory.x");
    }
}