Added base ISA env; added examples with interrupts

Author: romancardenas

e310x/build.rs

@@ -12,7 +12,9 @@ fn main() {
             .unwrap();
         println!("cargo:rustc-link-search={}", out.display());
         println!("cargo:rerun-if-changed=device.x");
-        println!("cargo:rustc-env=RISCV_MTVEC_ALIGN={}", 64usize);
+        println!("cargo:rustc-env=RISCV_RT_BASE_ISA=rv32i");
+        println!("cargo:rerun-if-env-changed=RISCV_RT_BASE_ISA");
+        println!("cargo:rustc-env=RISCV_MTVEC_ALIGN=64");
         println!("cargo:rerun-if-env-changed=RISCV_MTVEC_ALIGN");
     }
     println!("cargo:rerun-if-changed=build.rs");

e310x/settings.yaml

@@ -50,4 +50,5 @@ riscv_config:
     core_interrupt: "MachineExternal"
     hart_id: "H0"
 
+  base_isa: "rv32i"
   mtvec_align: 64

e310x/src/lib.rs

@@ -1,4 +1,4 @@
-#![doc = "Peripheral access API for FE310 microcontrollers (generated using svd2rust v0.36.1 (698a318 2025-06-08))\n\nYou can find an overview of the generated API [here].\n\nAPI features to be included in the [next] svd2rust release can be generated by cloning the svd2rust [repository], checking out the above commit, and running `cargo doc --open`.\n\n[here]: https://docs.rs/svd2rust/0.36.1/svd2rust/#peripheral-api\n[next]: https://github.com/rust-embedded/svd2rust/blob/master/CHANGELOG.md#unreleased\n[repository]: https://github.com/rust-embedded/svd2rust"]
+#![doc = "Peripheral access API for FE310 microcontrollers (generated using svd2rust v0.36.1 (6b2dd03 2025-06-26))\n\nYou can find an overview of the generated API [here].\n\nAPI features to be included in the [next] svd2rust release can be generated by cloning the svd2rust [repository], checking out the above commit, and running `cargo doc --open`.\n\n[here]: https://docs.rs/svd2rust/0.36.1/svd2rust/#peripheral-api\n[next]: https://github.com/rust-embedded/svd2rust/blob/master/CHANGELOG.md#unreleased\n[repository]: https://github.com/rust-embedded/svd2rust"]
 #![allow(non_camel_case_types)]
 #![allow(non_snake_case)]
 #![no_std]

hifive1-examples/examples/button_interrupt.rs

@@ -0,0 +1,99 @@
+//! Demonstration on how to configure the GPIO9 interrupt on HiFive boards.
+#![no_main]
+#![no_std]
+
+use hifive1::{
+    clock,
+    hal::DeviceResources,
+    hal::{e310x::Gpio0, prelude::*},
+    pin, sprintln, stdout, Led,
+};
+extern crate panic_halt;
+
+/* Handler for the GPIO9 interrupt */
+#[riscv_rt::external_interrupt(ExternalInterrupt::GPIO9)]
+fn gpio9_handler() {
+    sprintln!("GPIO9 interrupt!");
+    // Clear the GPIO pending interrupt
+    let gpio_block = unsafe { Gpio0::steal() };
+    let _prev_fall = gpio_block.fall_ip().read().pin9().bit_is_set();
+    let _prev_rise = gpio_block.rise_ip().read().pin9().bit_is_set();
+    // Clear the interrupt by writing 1 to the pending bit
+    gpio_block.fall_ip().write(|w| w.pin9().set_bit());
+    gpio_block.rise_ip().write(|w| w.pin9().set_bit());
+    let _post_fall = gpio_block.fall_ip().read().pin9().bit_is_set();
+    let _post_rise = gpio_block.rise_ip().read().pin9().bit_is_set();
+    let _ok = _prev_fall || _prev_rise; // Ensure we cleared the interrupt
+}
+
+#[riscv_rt::entry]
+fn main() -> ! {
+    let dr = DeviceResources::take().unwrap();
+    let cp = dr.core_peripherals;
+    let p = dr.peripherals;
+    let pins = dr.pins;
+
+    // Configure clocks
+    let clocks = clock::configure(p.PRCI, p.AONCLK, 320.mhz().into());
+
+    // Configure UART for stdout
+    stdout::configure(
+        p.UART0,
+        pin!(pins, uart0_tx),
+        pin!(pins, uart0_rx),
+        115_200.bps(),
+        clocks,
+    );
+
+    sprintln!("Configuring GPIOs...");
+    // Configure button pin (GPIO9) as pull-up input
+    let mut button = pins.pin9.into_pull_up_input();
+    // Configure blue LED pin (GPIO21) as inverted output
+    let mut led = pin!(pins, led_blue).into_inverted_output();
+
+    sprintln!("Configuring external interrupts...");
+    // Set button interrupt source priority
+    let plic = cp.plic;
+    let priorities = plic.priorities();
+    priorities.reset::<ExternalInterrupt>();
+    unsafe { priorities.set_priority(ExternalInterrupt::GPIO9, Priority::P1) };
+
+    // Enable GPIO9 interrupt for both edges
+    let gpio_block = unsafe { Gpio0::steal() };
+    unsafe {
+        // Clear pending interrupts from previous states
+        gpio_block.low_ie().write(|w| w.bits(0x00000000));
+        gpio_block.high_ie().write(|w| w.bits(0x00000000));
+        gpio_block.fall_ie().write(|w| w.bits(0x00000000));
+        gpio_block.rise_ie().write(|w| w.bits(0x00000000));
+        gpio_block.low_ip().write(|w| w.bits(0xffffffff));
+        gpio_block.high_ip().write(|w| w.bits(0xffffffff));
+        gpio_block.fall_ip().write(|w| w.bits(0xffffffff));
+        gpio_block.rise_ip().write(|w| w.bits(0xffffffff));
+    }
+    gpio_block.fall_ie().write(|w| w.pin9().set_bit());
+    gpio_block.rise_ie().write(|w| w.pin9().set_bit());
+
+    sprintln!("Enabling external interrupts...");
+    // Enable GPIO9 interrupt in PLIC
+    let ctx = plic.ctx0();
+    unsafe {
+        ctx.enables().disable_all::<ExternalInterrupt>();
+        ctx.threshold().set_threshold(Priority::P0);
+        ctx.enables().enable(ExternalInterrupt::GPIO9);
+        riscv::interrupt::enable();
+        plic.enable();
+    }
+
+    loop {
+        if button.is_low().unwrap() {
+            sprintln!("Button pressed");
+            led.on();
+        } else {
+            sprintln!("Button released");
+            led.off();
+        }
+        sprintln!("LED is on: {}", led.is_on());
+        riscv::asm::wfi();
+    }
+}

hifive1-examples/examples/led_blink_interrupt.rs

@@ -0,0 +1,61 @@
+//! Basic blinking LED example using mtime/mtimecmp registers for "sleep" in a loop.
+//! Blinks the blue LED of RED-V board.
+
+#![no_std]
+#![no_main]
+
+use hifive1::{
+    clock,
+    hal::{e310x::Clint, prelude::*, DeviceResources},
+    pin, sprintln, stdout, Led,
+};
+extern crate panic_halt;
+
+#[riscv_rt::core_interrupt(CoreInterrupt::MachineTimer)]
+fn mtimer_handler() {
+    let clint = unsafe { Clint::steal() };
+    let mtimer = clint.mtimer();
+    mtimer
+        .mtimecmp0()
+        .modify(|prev| *prev += mtimer.mtime_freq() as u64);
+}
+
+#[riscv_rt::entry]
+fn main() -> ! {
+    let dr = DeviceResources::take().unwrap();
+    let cp = dr.core_peripherals;
+    let p = dr.peripherals;
+    let pins = dr.pins;
+
+    // Configure clocks
+    let clocks = clock::configure(p.PRCI, p.AONCLK, 320.mhz().into());
+
+    // Configure UART for stdout
+    stdout::configure(
+        p.UART0,
+        pin!(pins, uart0_tx),
+        pin!(pins, uart0_rx),
+        115_200.bps(),
+        clocks,
+    );
+
+    // get blue LED pin
+    let pin = pin!(pins, led_blue);
+    let mut led = pin.into_inverted_output();
+
+    // Get the MTIMER peripheral from CLINT
+    let mtimer = cp.clint.mtimer();
+    mtimer.mtime().write(0);
+    mtimer.mtimecmp0().write(mtimer.mtime_freq() as u64); // Set the first compare value
+
+    unsafe {
+        mtimer.enable();
+        riscv::interrupt::enable();
+    }
+
+    loop {
+        Led::toggle(&mut led);
+        sprintln!("LED toggled. New state: {}", led.is_on());
+        riscv::asm::wfi();
+    }
+}